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

# Doubao Seed 2.0 Responses API - Referencia completa de API

> - 使用 Responses API 格式调用 Doubao Seed 2.0 系列模型
- **服务端上下文存储**：通过 `previous_response_id` 实现多轮对话，无需手动传历史消息
- **多模态输入**：支持文本 + 图像 + 视频 + 文件（PDF）混合输入
- **深度思考**：支持 thinking 思维链模式
- **工具调用**：支持 Function Calling、Búsqueda web、图像处理、MCP 工具、私域知识库、豆包助手
- **上下文缓存**：支持 caching 缓存机制降低成本
- **结构化输出**：支持 JSON Object / JSON Schema 格式
- **上下文管理**：支持 context_management 策略
- 💡 快速上手？查看 [快速开始文档](./doubao-seed-2.0-responses-quickstart)

<Note>
  **BaseURL**: La BaseURL predeterminada es `https://direct.evolink.ai`, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. `https://api.evolink.ai` es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.
</Note>


## OpenAPI

````yaml es/api-manual/language-series/doubao-seed-2.0/doubao-seed-2.0-responses-reference.json POST /v1/responses
openapi: 3.1.0
info:
  title: Referencia completa de Doubao Seed 2.0 Responses API
  description: >-
    Referencia completa de Doubao Seed 2.0 Responses API, incluyendo todos los
    parámetros y funciones avanzadas
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: Producción (recomendado)
  - url: https://api.evolink.ai
    description: URL alternativa
security:
  - bearerAuth: []
tags:
  - name: Responses API
    description: Interfaz de generación de chat de Responses API
paths:
  /v1/responses:
    post:
      tags:
        - Responses API
      summary: Doubao Seed 2.0 Responses API
      description: |-
        - 使用 Responses API 格式调用 Doubao Seed 2.0 系列模型
        - **服务端上下文存储**：通过 `previous_response_id` 实现多轮对话，无需手动传历史消息
        - **多模态输入**：支持文本 + 图像 + 视频 + 文件（PDF）混合输入
        - **深度思考**：支持 thinking 思维链模式
        - **工具调用**：支持 Function Calling、Búsqueda web、图像处理、MCP 工具、私域知识库、豆包助手
        - **上下文缓存**：支持 caching 缓存机制降低成本
        - **结构化输出**：支持 JSON Object / JSON Schema 格式
        - **上下文管理**：支持 context_management 策略
        - 💡 快速上手？查看 [快速开始文档](./doubao-seed-2.0-responses-quickstart)
      operationId: createResponseDoubaoSeed20
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponseRequest'
            examples:
              simple_text:
                summary: Entrada de texto plano
                value:
                  model: doubao-seed-2.0-pro
                  input: Por favor, preséntate
              multi_turn:
                summary: Conversación multi-turno (vía previous_response_id)
                value:
                  model: doubao-seed-2.0-pro
                  input: ¿Cuáles son sus ventajas?
                  previous_response_id: resp_0217****
              message_array:
                summary: Entrada de lista de mensajes
                value:
                  model: doubao-seed-2.0-pro
                  input:
                    - role: system
                      type: message
                      content: Eres un asistente profesional de programación Python.
                    - role: user
                      type: message
                      content: ¿Cómo leer un archivo?
              thinking_mode:
                summary: Activar modo de pensamiento profundo
                value:
                  model: doubao-seed-2.0-pro
                  input: Demuestra que la raíz cuadrada de 2 es irracional
                  thinking:
                    type: enabled
              web_search:
                summary: Búsqueda web
                value:
                  model: doubao-seed-2.0-pro
                  input: ¿Cómo está el clima en Beijing hoy?
                  tools:
                    - type: web_search
      responses:
        '200':
          description: Respuesta generada con éxito
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseObject'
        '400':
          description: Error en los parámetros de la solicitud
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 400
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: No autenticado, token inválido o expirado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 401
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Cuota insuficiente, necesita recargar
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 402
                  message: Insufficient quota
                  type: insufficient_quota_error
                  fallback_suggestion: https://evolink.ai/dashboard/billing
        '403':
          description: Acceso denegado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 403
                  message: Access denied for this model
                  type: permission_error
                  param: model
        '404':
          description: Recurso no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 404
                  message: Specified model not found
                  type: not_found_error
                  param: model
                  fallback_suggestion: doubao-seed-2.0-pro
        '413':
          description: Cuerpo de solicitud demasiado grande
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 413
                  message: File too large
                  type: request_too_large_error
                  fallback_suggestion: compress file to under 50MB
        '429':
          description: Límite de frecuencia de solicitudes excedido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 429
                  message: Rate limit exceeded
                  type: rate_limit_error
                  fallback_suggestion: retry after 60 seconds
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 500
                  message: Internal server error
                  type: internal_server_error
                  fallback_suggestion: try again later
        '502':
          description: Error del servicio upstream
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 502
                  message: Upstream AI service unavailable
                  type: upstream_error
                  fallback_suggestion: try different model
        '503':
          description: Servicio temporalmente no disponible
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 503
                  message: Service temporarily unavailable
                  type: service_unavailable_error
                  fallback_suggestion: retry after 30 seconds
components:
  schemas:
    ResponseRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: |-
            对话模型名称

            - `doubao-seed-2.0-pro`: 旗舰版，综合能力最强
            - `doubao-seed-2.0-lite`: 轻量版，速度更快
            - `doubao-seed-2.0-mini`: 极速版，响应最快
            - `doubao-seed-2.0-code`: 代码专用版
          enum:
            - doubao-seed-2.0-pro
            - doubao-seed-2.0-lite
            - doubao-seed-2.0-mini
            - doubao-seed-2.0-code
          default: doubao-seed-2.0-pro
          example: doubao-seed-2.0-pro
        input:
          description: |-
            输入内容。支持两种格式：

            **1. 纯文本字符串**: 等同于 user 角色输入的文本信息

            **2. 元素列表 (array)**: 包含消息、上下文、工具调用等多种输入类型
          oneOf:
            - type: string
              description: Entrada de texto plano
            - type: array
              description: 输入元素列表
              items:
                $ref: '#/components/schemas/InputItem'
        instructions:
          type: string
          nullable: true
          description: |-
            在模型上下文中插入系统消息或开发者指令作为第一条指令

            **注意**:
            - 与 previous_response_id 一起使用时，前一个回复中的指令不会被继承
            - 不可与 caching 缓存能力一起使用
        previous_response_id:
          type: string
          nullable: true
          description: |-
            上一个模型回复的唯一标识符，用于实现多轮对话

            **说明**:
            - 传入后会引入上一轮请求的输入和回答内容，本次请求的输入 tokens 会相应增加
            - 在多轮连续对话中，建议在每次请求之间加入约 100 毫秒的延迟
        expire_at:
          type: integer
          description: |-
            存储的过期时刻，UTC Unix 时间戳（秒）

            **说明**:
            - 取值范围: (创建时刻, 创建时刻 + 604800]，即最多保留 7 天
            - 默认值: 创建时刻 + 259200（3天）
            - 对 store 和 caching 都生效
            - 缓存存储时间计费，不满 1 小时按 1 小时计算
        max_output_tokens:
          type: integer
          nullable: true
          description: 模型输出最大 token 数，包含模型回答和思维链内容
          example: 32768
        thinking:
          type: object
          description: 控制模型是否Activar modo de pensamiento profundo
          properties:
            type:
              type: string
              description: |-
                思考模式

                - `enabled`: 开启思考模式，模型强制先思考再回答
                - `disabled`: 关闭思考模式，模型直接回答
                - `auto`: 自动思考模式，模型自主判断是否需要思考
              enum:
                - enabled
                - disabled
                - auto
          required:
            - type
        reasoning:
          type: object
          description: 限制深度思考的工作量，减少可使响应速度更快、token 用量更少
          properties:
            effort:
              type: string
              description: |-
                思考深度

                - `minimal`: 关闭思考，直接回答
                - `low`: 轻量思考，侧重快速响应
                - `medium`: 均衡模式，兼顾速度与深度
                - `high`: 深度分析，处理复杂问题
              enum:
                - minimal
                - low
                - medium
                - high
              default: medium
        caching:
          type: object
          description: |-
            是否开启上下文缓存

            **注意**: 不可与 instructions 字段、tools（除 Function Calling 外）字段一起使用
          properties:
            type:
              type: string
              description: |-
                缓存开关

                - `enabled`: 开启缓存
                - `disabled`: 关闭缓存
              enum:
                - enabled
                - disabled
              default: disabled
            prefix:
              type: boolean
              description: |-
                是否仅创建公共前缀缓存（模型不回复）

                - `true`: 仅创建公共前缀缓存
                - `false`: 不创建公共前缀缓存
              default: false
          required:
            - type
        store:
          type: boolean
          nullable: true
          description: |-
            是否储存生成的模型响应，以便后续通过 API 检索

            - `true`: 储存当前模型响应
            - `false`: 不储存
          default: true
        stream:
          type: boolean
          nullable: true
          description: |-
            响应内容是否流式返回

            - `false`: 模型生成完所有内容后一次性返回
            - `true`: 按 SSE 协议逐块返回，以 `data: [DONE]` 消息结束
          default: false
        temperature:
          type: number
          nullable: true
          description: |-
            采样温度，控制输出随机性

            - 取值范围: [0, 2]
            - 较低值更确定，较高值更随机
            - 建议仅调整 temperature 或 top_p 其中之一

            **注意**: doubao-seed-2.0-pro 和 doubao-seed-2.0-lite 固定为 1，手动指定会被忽略
          minimum: 0
          maximum: 2
          default: 1
        top_p:
          type: number
          nullable: true
          description: |-
            核采样概率阈值

            - 取值范围: [0, 1]
            - 建议仅调整 temperature 或 top_p 其中之一

            **注意**: doubao-seed-2.0-pro 和 doubao-seed-2.0-lite 固定为 0.95，手动指定会被忽略
          minimum: 0
          maximum: 1
          default: 0.7
        text:
          type: object
          description: 模型文本输出的格式定义
          properties:
            format:
              type: object
              description: 指定模型文本输出格式
              properties:
                type:
                  type: string
                  description: |-
                    格式类型

                    - `text`: 自然语言（默认）
                    - `json_object`: JSON 对象格式
                    - `json_schema`: 遵循 schema 定义的 JSON 格式
                  enum:
                    - text
                    - json_object
                    - json_schema
                  default: text
                name:
                  type: string
                  description: JSON 结构名称（type 为 json_schema 时必填）
                schema:
                  type: object
                  description: JSON Schema 格式定义（type 为 json_schema 时必填）
                description:
                  type: string
                  nullable: true
                  description: 回复用途描述
                strict:
                  type: boolean
                  nullable: true
                  description: 是否启用严格遵循模式
                  default: false
              required:
                - type
        tools:
          type: array
          description: |-
            模型可以调用的工具列表

            支持以下工具类型：
            - `function`: 自定义函数（Function Calling）
            - `web_search`: Búsqueda web
            - `doubao_app`: 豆包助手
            - `image_process`: 图像处理
            - `mcp`: MCP 工具
            - `knowledge_search`: 私域知识库搜索
          items:
            $ref: '#/components/schemas/Tool'
        tool_choice:
          description: |-
            控制模型是否调用工具

            **字符串模式**:
            - `none`: 不调用工具
            - `required`: 必须调用工具
            - `auto`: 模型自行判断（默认）

            **对象模式**: 指定调用特定工具
          oneOf:
            - type: string
              enum:
                - none
                - auto
                - required
            - $ref: '#/components/schemas/ToolChoiceObject'
        max_tool_calls:
          type: integer
          description: |-
            最大工具调用轮次（一轮不限次数）

            - 取值范围: [1, 10]
            - Web Search 默认值 3
            - Image Process 默认值 10（不支持修改）
            - Knowledge Search 默认值 3

            **注意**: 该参数为尽力而为机制，最终调用次数受模型推理效果等因素影响
          minimum: 1
          maximum: 10
        context_management:
          type: object
          description: 上下文管理策略，帮助模型有效利用上下文窗口
          properties:
            edits:
              type: array
              description: 上下文编辑策略列表
              items:
                $ref: '#/components/schemas/ContextEdit'
    ResponseObject:
      type: object
      properties:
        id:
          type: string
          description: 本次响应的唯一标识
          example: resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e
        object:
          type: string
          description: 对象类型，固定为 response
          enum:
            - response
          example: response
        created_at:
          type: number
          description: 创建时间的 Unix 时间戳（秒）
          example: 1771486674
        model:
          type: string
          description: 实际使用的模型名称和版本
          example: doubao-seed-2-0-code-preview-260215
        status:
          type: string
          description: |-
            响应状态

            - `completed`: 生成完成
            - `in_progress`: 生成中
            - `incomplete`: 未完成
            - `failed`: 失败
          enum:
            - completed
            - in_progress
            - incomplete
            - failed
          example: completed
        output:
          type: array
          description: 模型输出内容列表，包含思维链输出、消息输出、工具调用输出等
          items:
            $ref: '#/components/schemas/OutputItem'
        service_tier:
          type: string
          description: |-
            本次请求的服务等级

            - `default`: 默认服务等级
            - `scale`: 使用了保障包额度
          example: default
        instructions:
          type: string
          nullable: true
          description: 本次请求使用的系统指令
        previous_response_id:
          type: string
          nullable: true
          description: 引用的上一个响应 ID
        max_output_tokens:
          type: integer
          description: 模型输出最大 token 数
          example: 32768
        temperature:
          type: number
          nullable: true
          description: 使用的采样温度
        top_p:
          type: number
          nullable: true
          description: 使用的 top_p 值
        thinking:
          type: object
          nullable: true
          description: 使用的思考模式配置
        tools:
          type: array
          nullable: true
          description: 使用的工具列表
        tool_choice:
          nullable: true
          description: 使用的工具选择配置
        parallel_tool_calls:
          type: boolean
          nullable: true
          description: 是否允许并行工具调用
        text:
          type: object
          nullable: true
          description: 文本输出格式配置
        usage:
          $ref: '#/components/schemas/Usage'
        caching:
          type: object
          description: 缓存配置
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
        store:
          type: boolean
          description: 是否存储了响应
        expire_at:
          type: integer
          description: 存储过期时刻（Unix 时间戳）
          example: 1756539922
        error:
          type: object
          nullable: true
          description: 错误信息，成功时为 null
        incomplete_details:
          type: object
          nullable: true
          description: 未完成的详细原因
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
              description: HTTP状态错误代码
            message:
              type: string
              description: 错误描述信息
            type:
              type: string
              description: 错误类型
            param:
              type: string
              description: 相关参数名称
            fallback_suggestion:
              type: string
              description: 错误时的建议
    InputItem:
      type: object
      description: 输入元素，可以是消息、工具调用信息、工具返回信息或思维链信息
      properties:
        type:
          type: string
          description: |-
            输入类型

            - `message`: 消息输入
            - `function_call`: 工具函数调用信息
            - `function_call_output`: 工具返回信息
            - `reasoning`: 思维链信息
          enum:
            - message
            - function_call
            - function_call_output
            - reasoning
        role:
          type: string
          description: |-
            消息角色（type 为 message 时）

            - `user`: 用户消息
            - `system`: 系统消息
            - `assistant`: 助手消息
            - `developer`: 开发者消息（优先级高于 user）
          enum:
            - user
            - system
            - assistant
            - developer
        content:
          description: 消息内容，支持纯文本字符串或内容对象数组（文本、图片、视频、文件）
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/InputContentPart'
        partial:
          type: boolean
          description: |-
            续写模式（仅 assistant 角色）

            设置最后一条 assistant 消息的 partial 为 true，模型会基于 content 内容续写
        status:
          type: string
          description: 项目状态
          enum:
            - in_progress
            - completed
            - incomplete
        arguments:
          type: string
          description: 函数参数的 JSON 字符串（type 为 function_call 时必填）
        call_id:
          type: string
          description: 函数工具调用的唯一 ID（type 为 function_call/function_call_output 时必填）
        name:
          type: string
          description: 函数名称（type 为 function_call 时必填）
        output:
          type: string
          description: 工具输出结果（type 为 function_call_output 时必填）
        id:
          type: string
          description: 思维链信息的唯一标识（type 为 reasoning 时）
        summary:
          type: array
          description: 思维链内容（type 为 reasoning 时）
          items:
            type: object
            properties:
              text:
                type: string
                description: 思维链文本
              type:
                type: string
                description: 类型，固定为 summary_text
                enum:
                  - summary_text
    Tool:
      type: object
      description: 工具定义。根据 type 字段选择不同的工具类型
      required:
        - type
      properties:
        type:
          type: string
          description: |-
            工具类型

            - `function`: 自定义函数
            - `web_search`: Búsqueda web
            - `doubao_app`: 豆包助手
            - `image_process`: 图像处理
            - `mcp`: MCP 工具
            - `knowledge_search`: 私域知识库搜索
          enum:
            - function
            - web_search
            - doubao_app
            - image_process
            - mcp
            - knowledge_search
        name:
          type: string
          description: 函数名称（type 为 function 时必填）
        description:
          type: string
          description: 函数描述 / 知识库描述
        parameters:
          type: object
          description: 函数参数，JSON Schema 格式（type 为 function 时）
        strict:
          type: boolean
          description: 是否强制严格参数验证（type 为 function 时）
          default: true
        feature:
          type: object
          description: 豆包助手子功能（type 为 doubao_app 时）
          properties:
            chat:
              type: object
              description: 日常沟通功能
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
                role_description:
                  type: string
                  description: 角色设定（与 system prompt / instructions 互斥）
            deep_chat:
              type: object
              description: 深度沟通功能
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
                role_description:
                  type: string
                  description: 角色设定
            ai_search:
              type: object
              description: Búsqueda web功能
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
                role_description:
                  type: string
                  description: 角色设定
            reasoning_search:
              type: object
              description: 边想边搜功能
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
                role_description:
                  type: string
                  description: 角色设定
        user_location:
          type: object
          description: 用户地理位置（type 为 doubao_app / web_search 时）
          properties:
            type:
              type: string
              description: 位置类型
              default: approximate
            country:
              type: string
              description: 国家
            region:
              type: string
              description: 省份/地区
            city:
              type: string
              description: 城市
        sources:
          type: array
          description: |-
            Búsqueda web附加内容源（type 为 web_search 时）

            - `toutiao`: 头条图文
            - `douyin`: 抖音百科
            - `moji`: 墨迹天气
          items:
            type: string
            enum:
              - toutiao
              - douyin
              - moji
        limit:
          type: integer
          description: |-
            最大召回条数

            - web_search: [1, 50]，默认 10
            - knowledge_search: [1, 200]，默认 10
        max_keyword:
          type: integer
          description: 最大并行搜索关键词数量，取值范围 [1, 50]（web_search / knowledge_search）
        point:
          type: object
          description: 画点/连线功能（type 为 image_process 时）
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        grounding:
          type: object
          description: 框选/裁剪功能（type 为 image_process 时）
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        zoom:
          type: object
          description: 缩放功能（type 为 image_process 时）
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        rotate:
          type: object
          description: 旋转功能（type 为 image_process 时）
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        server_label:
          type: string
          description: MCP Server 标签（type 为 mcp 时必填）
        server_url:
          type: string
          description: MCP Server 访问地址（type 为 mcp 时必填）
        headers:
          type: object
          description: MCP 服务器 HTTP 请求头（type 为 mcp 时）
          additionalProperties:
            type: string
        require_approval:
          description: |-
            MCP 工具审批设置（type 为 mcp 时）

            **字符串模式**: `always`（所有需确认）/ `never`（无需确认）

            **对象模式**: 指定哪些工具需要/不需要审批
          oneOf:
            - type: string
              enum:
                - always
                - never
            - type: object
              properties:
                always:
                  type: object
                  properties:
                    tool_names:
                      type: array
                      items:
                        type: string
                      description: 需要确认的工具名称列表
                never:
                  type: object
                  properties:
                    tool_names:
                      type: array
                      items:
                        type: string
                      description: 不需要确认的工具名称列表
        allowed_tools:
          description: |-
            MCP 工具加载范围（type 为 mcp 时）

            **数组模式**: 允许加载的工具名称列表

            **对象模式**: 通过 tool_names 指定
          oneOf:
            - type: array
              items:
                type: string
            - type: object
              properties:
                tool_names:
                  type: array
                  items:
                    type: string
        knowledge_resource_id:
          type: string
          description: 私域知识库 ID（type 为 knowledge_search 时必填）
        doc_filters:
          type: object
          description: 知识库检索过滤条件（type 为 knowledge_search 时）
        dense_weight:
          type: number
          description: |-
            稠密向量权重（type 为 knowledge_search 时）

            - 取值范围: [0.2, 1]
            - 1 表示纯稠密检索，趋向 0 表示纯字面检索
            - 仅在混合检索（hnsw_hybrid）时有效
          minimum: 0.2
          maximum: 1
          default: 0.5
        ranking_options:
          type: object
          description: 知识库检索后处理选项（type 为 knowledge_search 时）
          properties:
            rerank_switch:
              type: boolean
              description: 是否自动 rerank
              default: false
            retrieve_count:
              type: integer
              description: 进入重排的切片数量（rerank_switch 为 true 时生效）
              default: 25
            get_attachment_link:
              type: boolean
              description: 是否获取切片中图片的临时下载链接
              default: false
            chunk_diffusion_count:
              type: integer
              description: |-
                返回命中切片的上下几片邻近切片

                取值范围: [0, 5]，0 表示不进行 chunk diffusion
              minimum: 0
              maximum: 5
              default: 0
            chunk_group:
              type: boolean
              description: 文本聚合，根据文档及顺序对切片重新聚合排序
              default: false
            rerank_model:
              type: string
              description: |-
                rerank 模型选择

                - `base-multilingual-rerank`（推荐）: 速度快、长文本、70+ 种语言
                - `m3-v2-rerank`: 常规文本、100+ 种语言
              enum:
                - base-multilingual-rerank
                - m3-v2-rerank
              default: base-multilingual-rerank
            rerank_only_chunk:
              type: boolean
              description: |-
                是否仅根据 chunk 内容计算重排分数

                - `true`: 只根据 chunk 内容
                - `false`: 根据 chunk title + 内容
              default: false
    ToolChoiceObject:
      type: object
      required:
        - type
      description: 指定调用特定工具
      properties:
        type:
          type: string
          description: |-
            工具类型

            - `function`: 自定义函数，需填 name 字段
            - 其他内置工具名称
        name:
          type: string
          description: 待调用工具的名称（type 为 function 时必填）
    ContextEdit:
      type: object
      description: 上下文编辑策略
      properties:
        type:
          type: string
          description: |-
            策略类型

            - `clear_thinking`: 思考块清除
            - `clear_tool_uses`: 工具调用内容清除
          enum:
            - clear_thinking
            - clear_tool_uses
        keep:
          description: |-
            内容保留策略

            **字符串模式**: `all`（保留所有思维链）

            **对象模式**: 指定保留策略
          oneOf:
            - type: string
              enum:
                - all
            - type: object
              properties:
                type:
                  type: string
                  description: |-
                    保留策略类型

                    - `thinking_turns`: 保留最近 N 轮思维链
                    - `tool_uses`: 保留最近 N 轮工具调用
                  enum:
                    - thinking_turns
                    - tool_uses
                value:
                  type: integer
                  description: 保留轮数
                  default: 1
        exclude_tools:
          type: array
          description: 不会被清除的工具名称列表（type 为 clear_tool_uses 时）
          items:
            type: string
        clear_tool_input:
          type: boolean
          description: 是否清除工具调用参数（type 为 clear_tool_uses 时）
          default: false
        trigger:
          type: object
          description: 触发清除策略的阈值（type 为 clear_tool_uses 时）
          properties:
            type:
              type: string
              description: 触发类型
              enum:
                - tool_uses
            value:
              type: integer
              description: 工具调用达到 N 轮时触发清除
    OutputItem:
      oneOf:
        - $ref: '#/components/schemas/ReasoningOutput'
        - $ref: '#/components/schemas/MessageOutput'
        - $ref: '#/components/schemas/FunctionCallOutput'
    Usage:
      type: object
      description: Token 使用统计信息
      properties:
        input_tokens:
          type: integer
          description: 输入 token 数量
          example: 88
        input_tokens_details:
          type: object
          description: 输入 token 详细信息
          properties:
            cached_tokens:
              type: integer
              description: 缓存 token 数量
              example: 0
        output_tokens:
          type: integer
          description: 输出 token 数量
          example: 230
        output_tokens_details:
          type: object
          description: 输出 token 详细信息
          properties:
            reasoning_tokens:
              type: integer
              description: 推理/思维链 token 数量
              example: 211
        total_tokens:
          type: integer
          description: 总 token 数量
          example: 318
    InputContentPart:
      oneOf:
        - $ref: '#/components/schemas/InputText'
        - $ref: '#/components/schemas/InputImage'
        - $ref: '#/components/schemas/InputVideo'
        - $ref: '#/components/schemas/InputFile'
    ReasoningOutput:
      title: 思维链输出
      type: object
      properties:
        id:
          type: string
          description: 输出项 ID
          example: rs_0217****404a
        type:
          type: string
          description: 输出类型
          enum:
            - reasoning
        summary:
          type: array
          description: 思维链内容
          items:
            type: object
            properties:
              text:
                type: string
                description: 思维链文本
              type:
                type: string
                enum:
                  - summary_text
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
          example: completed
    MessageOutput:
      title: 消息输出
      type: object
      properties:
        id:
          type: string
          description: 输出项 ID
          example: msg_0217****a93c
        type:
          type: string
          enum:
            - message
        role:
          type: string
          enum:
            - assistant
        content:
          type: array
          description: 消息内容列表
          items:
            type: object
            properties:
              text:
                type: string
                description: 文本内容
              type:
                type: string
                description: 内容类型
                enum:
                  - output_text
              annotations:
                type: array
                nullable: true
                description: 注释信息（Búsqueda web来源等）
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
          example: completed
    FunctionCallOutput:
      title: 工具调用输出
      type: object
      properties:
        id:
          type: string
          description: 输出项 ID
        type:
          type: string
          enum:
            - function_call
        call_id:
          type: string
          description: 调用 ID
        name:
          type: string
          description: 函数名称
        arguments:
          type: string
          description: 函数参数 JSON 字符串
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
    InputText:
      title: 文本输入
      type: object
      required:
        - type
        - text
      properties:
        type:
          type: string
          enum:
            - input_text
          description: 输入类型，固定为 input_text
        text:
          type: string
          description: 输入文本内容
    InputImage:
      title: 图片输入
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - input_image
          description: 输入类型，固定为 input_image
        image_url:
          type: string
          description: 图片 URL 或 Base64 编码的 data URL
        file_id:
          type: string
          description: 通过 Files API 上传后返回的文件 ID
        detail:
          type: string
          description: |-
            图片理解精细度

            - `low`: 低精细度
            - `high`: 高精细度
            - `xhigh`: 超高精细度
          enum:
            - low
            - high
            - xhigh
        image_pixel_limit:
          type: object
          nullable: true
          description: |-
            图片像素范围限制

            优先级高于 detail 字段。像素范围需在 [196, 36000000]
          properties:
            max_pixels:
              type: integer
              description: |-
                最大像素限制

                - doubao-seed-1.8 之前: (min_pixels, 4014080]
                - doubao-seed-2.0: (min_pixels, 9031680]
            min_pixels:
              type: integer
              description: |-
                最小像素限制

                - doubao-seed-1.8 之前: [3136, max_pixels)
                - doubao-seed-2.0: [1764, max_pixels)
    InputVideo:
      title: 视频输入
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - input_video
          description: 输入类型，固定为 input_video
        video_url:
          type: string
          description: 视频 URL 或 Base64 编码的 data URL
        file_id:
          type: string
          description: |-
            通过 Files API 上传后返回的文件 ID

            **注意**: 使用 file_id 时，fps 参数失效
        fps:
          type: number
          description: |-
            抽帧频率

            - 取值范围: [0.2, 5]
            - 取值越高，对画面变化越敏感
            - 取值越低，token 花费少，速度更快
          minimum: 0.2
          maximum: 5
    InputFile:
      title: 文件输入
      type: object
      required:
        - type
      description: 当前仅支持 PDF 文件
      properties:
        type:
          type: string
          enum:
            - input_file
          description: 输入类型，固定为 input_file
        file_id:
          type: string
          description: 通过 Files API 上传后返回的文件 ID
        file_data:
          type: string
          description: 文件内容的 Base64 编码（单个文件不超过 50MB）
        filename:
          type: string
          description: 文件名（使用 file_data 时必填）
        file_url:
          type: string
          description: 文件的可访问 URL（文件不超过 50MB）
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |-
        ##所有接口均需要使用Bearer Token进行认证##

        **获取 API Key：**

        访问 [API Key 管理页面](https://evolink.ai/dashboard/keys) 获取您的 API Key

        **使用时在请求头中添加：**
        ```
        Authorization: Bearer YOUR_API_KEY
        ```

````