curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seed-2.0-pro",
  "input": "Por favor, preséntate"
}
'

{
  "id": "resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e",
  "object": "response",
  "created_at": 1771486674,
  "model": "doubao-seed-2-0-code-preview-260215",
  "status": "completed",
  "output": [
    {
      "id": "rs_0217****404a",
      "type": "reasoning",
      "summary": [
        {
          "text": "<string>",
          "type": "summary_text"
        }
      ],
      "status": "completed"
    }
  ],
  "service_tier": "default",
  "instructions": "<string>",
  "previous_response_id": "<string>",
  "max_output_tokens": 32768,
  "temperature": 123,
  "top_p": 123,
  "thinking": {},
  "tools": "<array>",
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "text": {},
  "usage": {
    "input_tokens": 88,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 230,
    "output_tokens_details": {
      "reasoning_tokens": 211
    },
    "total_tokens": 318
  },
  "caching": {
    "type": "enabled"
  },
  "store": true,
  "expire_at": 1756539922,
  "error": {},
  "incomplete_details": {}
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "doubao-seed-2.0-pro"
  }
}

{
  "error": {
    "code": 413,
    "message": "File too large",
    "type": "request_too_large_error",
    "fallback_suggestion": "compress file to under 50MB"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try different model"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Responses API

Doubao Seed 2.0 Responses API - Referencia completa de API

Llamada a los modelos de la serie Doubao Seed 2.0 con el formato Responses API
Almacenamiento de contexto en el servidor: conversaciones multiturno mediante previous_response_id, sin necesidad de enviar manualmente el historial de mensajes
Entrada multimodal: admite entrada mixta de texto + imagen + video + archivo (PDF)
Pensamiento profundo: admite el modo de cadena de razonamiento thinking
Llamada a herramientas: admite Function Calling, búsqueda web, procesamiento de imágenes, herramientas MCP, base de conocimiento privada y asistente Doubao
Caché de contexto: admite el mecanismo de caché caching para reducir costes
Salida estructurada: admite los formatos JSON Object / JSON Schema
Gestión del contexto: admite la estrategia context_management
¿Quieres empezar rápido? Consulta la guía de inicio rápido

POST

responses

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seed-2.0-pro",
  "input": "Por favor, preséntate"
}
'

{
  "id": "resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e",
  "object": "response",
  "created_at": 1771486674,
  "model": "doubao-seed-2-0-code-preview-260215",
  "status": "completed",
  "output": [
    {
      "id": "rs_0217****404a",
      "type": "reasoning",
      "summary": [
        {
          "text": "<string>",
          "type": "summary_text"
        }
      ],
      "status": "completed"
    }
  ],
  "service_tier": "default",
  "instructions": "<string>",
  "previous_response_id": "<string>",
  "max_output_tokens": 32768,
  "temperature": 123,
  "top_p": 123,
  "thinking": {},
  "tools": "<array>",
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "text": {},
  "usage": {
    "input_tokens": 88,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 230,
    "output_tokens_details": {
      "reasoning_tokens": 211
    },
    "total_tokens": 318
  },
  "caching": {
    "type": "enabled"
  },
  "store": true,
  "expire_at": 1756539922,
  "error": {},
  "incomplete_details": {}
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "doubao-seed-2.0-pro"
  }
}

{
  "error": {
    "code": 413,
    "message": "File too large",
    "type": "request_too_large_error",
    "fallback_suggestion": "compress file to under 50MB"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try different model"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

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.

Autorizaciones

Authorization

string

header

requerido

Todas las APIs requieren autenticación Bearer Token

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:doubao-seed-2.0-pro

requerido

Nombre del modelo de conversación

doubao-seed-2.0-pro: versión insignia, mayor capacidad global
doubao-seed-2.0-lite: versión ligera, más rápida
doubao-seed-2.0-mini: versión ultrarrápida, respuesta más veloz
doubao-seed-2.0-code: versión especializada en código

Opciones disponibles:

doubao-seed-2.0-pro,

doubao-seed-2.0-lite,

doubao-seed-2.0-mini,

doubao-seed-2.0-code

Ejemplo:

"doubao-seed-2.0-pro"

input

requerido

Contenido de entrada. Admite dos formatos:

1. Cadena de texto plano: equivalente al texto introducido con el rol user

2. Lista de elementos (array): contiene varios tipos de entrada, como mensajes, contexto y llamadas a herramientas

instructions

string | null

Inserta un mensaje de sistema o una instrucción de desarrollador como primera instrucción del contexto del modelo

Nota:

Al usarse con previous_response_id, las instrucciones de la respuesta anterior no se heredan
No puede usarse junto con la funcionalidad de caché caching

previous_response_id

string | null

Identificador único de la respuesta anterior del modelo, utilizado para implementar conversaciones multiturno

Nota:

Al proporcionarlo se incorporan la entrada y la respuesta de la ronda anterior, por lo que los tokens de entrada de esta solicitud aumentan en consecuencia
En conversaciones multiturno continuas se recomienda añadir unos 100 milisegundos de retardo entre solicitudes

expire_at

integer

Momento de expiración del almacenamiento, marca de tiempo Unix UTC (segundos)

Nota:

Rango de valores: (momento de creación, momento de creación + 604800], es decir, una retención máxima de 7 días
Valor predeterminado: momento de creación + 259200 (3 días)
Se aplica tanto a store como a caching
El tiempo de almacenamiento en caché se factura; cualquier fracción inferior a 1 hora se cuenta como 1 hora

max_output_tokens

integer | null

Número máximo de tokens de salida del modelo, incluidos la respuesta y la cadena de razonamiento

Ejemplo:

32768

thinking

object

Controla si el modelo activa el modo de pensamiento profundo

Show child attributes

reasoning

object

Limita el esfuerzo de pensamiento profundo; reducirlo acelera la respuesta y consume menos tokens

Show child attributes

caching

object

Indica si se activa la caché de contexto

Nota: no puede usarse junto con el campo instructions ni con el campo tools (excepto Function Calling)

Show child attributes

store

boolean | null

predeterminado:true

Indica si se almacena la respuesta generada por el modelo para recuperarla después mediante la API

true: almacenar la respuesta actual del modelo
false: no almacenarla

stream

boolean | null

predeterminado:false

Indica si el contenido de la respuesta se devuelve en streaming

false: el modelo devuelve todo el contenido de una vez cuando termina de generarlo
true: devuelve el contenido por bloques según el protocolo SSE, finalizando con un mensaje data: [DONE]

temperature

number | null

predeterminado:1

Temperatura de muestreo, controla la aleatoriedad de la salida

Rango de valores: [0, 2]
Los valores bajos son más deterministas y los altos más aleatorios
Se recomienda ajustar solo temperature o top_p

Nota: doubao-seed-2.0-pro y doubao-seed-2.0-lite están fijados en 1; cualquier valor indicado manualmente se ignora

Rango requerido: 0 <= x <= 2

top_p

number | null

predeterminado:0.7

Umbral de probabilidad del muestreo nucleus

Rango de valores: [0, 1]
Se recomienda ajustar solo temperature o top_p

Nota: doubao-seed-2.0-pro y doubao-seed-2.0-lite están fijados en 0.95; cualquier valor indicado manualmente se ignora

Rango requerido: 0 <= x <= 1

text

object

Definición del formato de salida de texto del modelo

Show child attributes

tools

object[]

Lista de herramientas que el modelo puede invocar

Tipos de herramientas admitidos:

function: función personalizada (Function Calling)
web_search: búsqueda web
doubao_app: asistente Doubao
image_process: procesamiento de imágenes
mcp: herramientas MCP
knowledge_search: búsqueda en base de conocimiento privada

Show child attributes

tool_choice

Controla si el modelo invoca herramientas

Modo cadena:

none: no invocar herramientas
required: debe invocar herramientas
auto: el modelo decide (predeterminado)

Modo objeto: especificar una herramienta concreta a invocar

Opciones disponibles:

none,

auto,

required

max_tool_calls

integer

Número máximo de rondas de llamadas a herramientas (sin límite de llamadas por ronda)

Rango de valores: [1, 10]
Web Search: 3 por defecto
Image Process: 10 por defecto (no modificable)
Knowledge Search: 3 por defecto

Nota: este parámetro funciona en la medida de lo posible; el número real de llamadas depende, entre otros factores, del rendimiento del razonamiento del modelo

Rango requerido: 1 <= x <= 10

context_management

object

Estrategia de gestión del contexto para ayudar al modelo a aprovechar eficazmente la ventana de contexto

Show child attributes

Respuesta

Respuesta generada con éxito

string

Identificador único de esta respuesta

Ejemplo:

"resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e"

object

enum<string>

Tipo de objeto, valor fijo response

Opciones disponibles:

response

Ejemplo:

"response"

created_at

number

Marca de tiempo Unix de creación (segundos)

Ejemplo:

1771486674

model

string

Nombre y versión del modelo realmente utilizado

Ejemplo:

"doubao-seed-2-0-code-preview-260215"

status

enum<string>

Estado de la respuesta

completed: generación completada
in_progress: generación en curso
incomplete: incompleta
failed: fallida

Opciones disponibles:

completed,

in_progress,

incomplete,

failed

Ejemplo:

"completed"

output

(Salida de la cadena de razonamiento · object | Salida de mensaje · object | Salida de la llamada a la herramienta · object)[]

Lista de contenidos de salida del modelo: salida de la cadena de razonamiento, salida de mensaje, salida de llamada a herramientas, etc.

Salida de la cadena de razonamiento
Salida de mensaje
Salida de la llamada a la herramienta

Show child attributes

service_tier

string

Nivel de servicio de esta solicitud

default: nivel de servicio predeterminado
scale: se utilizó el cupo del paquete garantizado

Ejemplo:

"default"

instructions

string | null

Instrucciones del sistema utilizadas para esta solicitud

previous_response_id

string | null

ID de la respuesta anterior referenciada

max_output_tokens

integer

Número máximo de tokens de salida del modelo

Ejemplo:

32768

temperature

number | null

Temperatura de muestreo utilizada

top_p

number | null

Valor top_p utilizado

thinking

object | null

Configuración del modo de pensamiento utilizada

tools

array | null

Lista de herramientas utilizadas

tool_choice

any | null

Configuración de selección de herramientas utilizada

parallel_tool_calls

boolean | null

Indica si se permiten llamadas a herramientas en paralelo

text

object | null

Configuración del formato de salida de texto

usage

object

Estadísticas de uso de tokens

Show child attributes

caching

object

Configuración de caché

Show child attributes

store

boolean

Indica si la respuesta se almacenó

expire_at

integer

Momento de expiración del almacenamiento (marca de tiempo Unix)

Ejemplo:

1756539922

error

object | null

Información de error, null si la operación tiene éxito

incomplete_details

object | null

Razón detallada de la falta de finalización

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Doubao Seed 2.0 Responses API - Referencia completa de API

Autorizaciones

Todas las APIs requieren autenticación Bearer Token

Cuerpo

Respuesta