> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aitoearn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 发布选项可选值

> 接口说明：查询某个已授权渠道账号在指定发布选项字段下的可选值，用于在创建发布任务前让用户选择平台要求的额外参数。

所有平台侧额外参数的查询都使用本接口。典型场景包括 B 站分区 `tid`、YouTube 分类 `categoryId`、Threads 地点 `location_id`、Pinterest Board `boardId`。

调用流程：先调用[「平台发布选项」](/api-reference/get-api-v2-channels-platforms-platform-publish-options)接口（`GET /api/v2/channels/platforms/{platform}/publish-options`）查询该平台有哪些额外参数；将返回项中的 `field` 放到本接口路径参数 `field`。如果返回项包含 `filterSchema`，按该 schema 将过滤条件作为本接口 query 参数传入，例如 Threads 地点可传 `keyword` 或经纬度。



## OpenAPI

````yaml /openapi/zh/aitoearn.openapi.json get /api/v2/channels/accounts/{accountId}/publish-options/{field}/values
openapi: 3.0.1
info:
  title: AiToEarn 开放平台 API
  description: AiToEarn 开放平台 API，支持在中国站与国际站之间切换调试。业务是否成功以响应体 code === 0 为准。
  version: 1.0.0
  contact: {}
servers:
  - url: https://aitoearn.cn
    description: 中国站
  - url: https://aitoearn.ai
    description: 国际站
security: []
tags:
  - name: AI 服务
  - name: AI 服务/视频生成
  - name: AI 服务/图像生成
  - name: 渠道管理
  - name: 渠道管理/账号
  - name: 渠道管理/内容发布
  - name: 渠道管理/平台
  - name: 渠道管理/作品
  - name: 渠道管理/账号分组
  - name: 渠道管理/授权
  - name: 资源管理
  - name: AI 服务/大语言模型
  - name: AI 服务/真人素材
  - name: AI 服务/Agent
paths:
  /api/v2/channels/accounts/{accountId}/publish-options/{field}/values:
    get:
      tags:
        - 渠道管理/账号
      summary: 发布选项可选值
      description: >-
        接口说明：查询某个已授权渠道账号在指定发布选项字段下的可选值，用于在创建发布任务前让用户选择平台要求的额外参数。


        所有平台侧额外参数的查询都使用本接口。典型场景包括 B 站分区 `tid`、YouTube 分类 `categoryId`、Threads 地点
        `location_id`、Pinterest Board `boardId`。


        调用流程：先调用[「平台发布选项」](/api-reference/get-api-v2-channels-platforms-platform-publish-options)接口（`GET
        /api/v2/channels/platforms/{platform}/publish-options`）查询该平台有哪些额外参数；将返回项中的
        `field` 放到本接口路径参数 `field`。如果返回项包含 `filterSchema`，按该 schema 将过滤条件作为本接口
        query 参数传入，例如 Threads 地点可传 `keyword` 或经纬度。
      operationId: AccountsController_publishOptionValues_v2
      parameters:
        - name: accountId
          in: path
          description: 渠道账号 ID。必须是当前用户已授权的账号，且账号所属平台应与「平台发布选项」接口中查询的平台一致。
          required: true
          example: ''
          schema:
            type: string
            description: 渠道账号 ID。必须是当前用户已授权的账号，且账号所属平台应与「平台发布选项」接口中查询的平台一致。
        - name: field
          in: path
          description: >-
            发布选项字段。取值来自[「平台发布选项」](/api-reference/get-api-v2-channels-platforms-platform-publish-options)接口返回的
            `data[n].field`，例如 `tid`、`categoryId`、`location_id`、`boardId`。
          required: true
          example: ''
          schema:
            type: string
            description: >-
              发布选项字段。取值来自[「平台发布选项」](/api-reference/get-api-v2-channels-platforms-platform-publish-options)接口返回的
              `data[n].field`，例如 `tid`、`categoryId`、`location_id`、`boardId`。
      responses:
        '200':
          description: 请求已被服务处理。业务是否成功以响应体 code === 0 为准。
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      field:
                        type: string
                      valueType:
                        type: string
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            label:
                              type: string
                            description:
                              type: string
                            disabled:
                              type: boolean
                            children:
                              type: array
                              items:
                                type: object
                                properties:
                                  value:
                                    type: string
                                  label:
                                    type: string
                                  description:
                                    type: string
                                  extra:
                                    type: object
                                    properties:
                                      parent:
                                        type: number
                                    additionalProperties: true
                                additionalProperties: false
                            extra:
                              type: object
                              properties:
                                parent:
                                  type: number
                              additionalProperties: true
                          additionalProperties: false
                    additionalProperties: false
                  code:
                    type: integer
                    description: 业务状态码。0 表示成功，非 0 表示业务错误。
                  message:
                    type: string
                    description: 响应消息。
                  requestId:
                    type: string
                    description: 请求 ID。
                  timestamp:
                    type: integer
                    description: 错误响应时间戳，Unix 毫秒。
              examples:
                success:
                  summary: 成功
                  value:
                    code: 0
                    message: 请求成功
                    data:
                      field: string
                      valueType: string
                      items:
                        - value: string
                          label: string
                          description: string
                          disabled: boolean
                          children:
                            - value: string
                              label: string
                              description: string
                              extra:
                                parent: number
                          extra:
                            parent: number
                    requestId: string
      deprecated: false
      security:
        - apikey-header-X-Api-Key: []
components:
  securitySchemes:
    apikey-header-X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: 需要从 AiToEarn 获取 API Key。点击前往[「API Key 获取教程」](/zh/use/api-key)。

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.