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

{
  "id": "0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50",
  "model": "doubao-seed-2-0-pro-260215",
  "object": "chat.completion",
  "service_tier": "default",
  "created": 1771485416,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "¡Hola! Doubao Seed 2.0 es el modelo de lenguaje de nueva generación de ByteDance, con capacidades más potentes de razonamiento, comprensión multimodal y pensamiento profundo.",
        "reasoning_content": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "function",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ]
      },
      "finish_reason": "stop",
      "logprobs": {
        "content": [
          {
            "token": "<string>",
            "bytes": [
              123
            ],
            "logprob": 123,
            "top_logprobs": [
              {
                "token": "<string>",
                "bytes": [
                  123
                ],
                "logprob": 123
              }
            ]
          }
        ]
      },
      "moderation_hit_type": "severe_violation"
    }
  ],
  "usage": {
    "total_tokens": 271,
    "prompt_tokens": 15,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens": 256,
    "completion_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

{
  "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": "Image file too large",
    "type": "request_too_large_error",
    "param": "content",
    "fallback_suggestion": "compress image to under 10MB"
  }
}

{
  "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"
  }
}

Chat Completions API

Doubao Seed 2.0 - Referencia completa de API

Llamada a los modelos de la serie Doubao Seed 2.0 con el formato OpenAI SDK
Modo de procesamiento sincrónico, devuelve el contenido de la conversación en tiempo real
Conversación de texto plano: conversación contextual de uno o varios turnos
Prompt del sistema: personaliza el rol y el comportamiento de la IA
Entrada multimodal: admite entrada mixta de texto + imagen + video
Pensamiento profundo: admite el modo de cadena de razonamiento para un razonamiento profundo
Llamada a herramientas: admite Function Calling
Salida estructurada: admite los formatos JSON Object / JSON Schema
¿Quieres empezar rápido? Consulta la guía de inicio rápido

POST

chat

completions

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

{
  "id": "0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50",
  "model": "doubao-seed-2-0-pro-260215",
  "object": "chat.completion",
  "service_tier": "default",
  "created": 1771485416,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "¡Hola! Doubao Seed 2.0 es el modelo de lenguaje de nueva generación de ByteDance, con capacidades más potentes de razonamiento, comprensión multimodal y pensamiento profundo.",
        "reasoning_content": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "function",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ]
      },
      "finish_reason": "stop",
      "logprobs": {
        "content": [
          {
            "token": "<string>",
            "bytes": [
              123
            ],
            "logprob": 123,
            "top_logprobs": [
              {
                "token": "<string>",
                "bytes": [
                  123
                ],
                "logprob": 123
              }
            ]
          }
        ]
      },
      "moderation_hit_type": "severe_violation"
    }
  ],
  "usage": {
    "total_tokens": 271,
    "prompt_tokens": 15,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens": 256,
    "completion_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

{
  "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": "Image file too large",
    "type": "request_too_large_error",
    "param": "content",
    "fallback_suggestion": "compress image to under 10MB"
  }
}

{
  "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, ideal para razonamiento complejo y generación de alta calidad
doubao-seed-2.0-lite: versión ligera, más rápida y con buena relación calidad-precio
doubao-seed-2.0-mini: versión ultrarrápida, respuesta más veloz, adecuada para tareas simples
doubao-seed-2.0-code: versión especializada en código, optimizada para generar y comprender 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"

messages

object[]

requerido

Lista de mensajes de la conversación; admite conversaciones multiturno y entrada multimodal (texto, imagen, video)

Minimum array length: 1

Show child attributes

thinking

object

Controla si el modelo activa el modo de pensamiento profundo

La compatibilidad y los valores predeterminados varían según el modelo

Show child attributes

stream

boolean

predeterminado:false

Indica si el contenido de la respuesta se devuelve en streaming

false: el modelo devuelve el resultado de una vez tras generar todo el contenido
true: el contenido generado por el modelo se devuelve por bloques según el protocolo SSE y finaliza con un mensaje data: [DONE]. Cuando stream es true, el campo stream_options permite obtener las estadísticas de consumo de tokens

Ejemplo:

false

stream_options

object | null

Streaming response options. Can be set when stream is true.

Show child attributes

max_tokens

integer | null

predeterminado:4096

Longitud máxima de la respuesta del modelo (en tokens)

Nota:

La respuesta del modelo no incluye la cadena de razonamiento (respuesta del modelo = salida del modelo - cadena de razonamiento)
La longitud total de los tokens de salida también está limitada por la longitud de contexto del modelo
No puede establecerse junto con max_completion_tokens

Ejemplo:

4096

max_completion_tokens

integer | null

Controla la longitud máxima de salida del modelo, incluidos la respuesta y la cadena de razonamiento (en tokens)

Nota:

Rango de valores: [0, 65536]
Al configurarlo, el valor predeterminado de max_tokens deja de aplicarse: el modelo genera el contenido necesario (respuesta y cadena de razonamiento) hasta alcanzar este valor
No puede establecerse junto con max_tokens
Se recomienda al activar el modo de pensamiento profundo

Rango requerido: 0 <= x <= 65536

Ejemplo:

16384

temperature

number | null

predeterminado:1

Temperatura de muestreo, controla la aleatoriedad de la salida

Nota:

Rango de valores: [0, 2]
Valores bajos (p. ej. 0.2): salida más determinista y enfocada
Valores altos (p. ej. 0.8): salida más aleatoria y creativa
Con el valor 0, el modelo solo considera el token con la mayor probabilidad logarítmica
Se recomienda ajustar solo temperature o top_p

Rango requerido: 0 <= x <= 2

Ejemplo:

0.7

top_p

number | null

predeterminado:0.7

Umbral de probabilidad del muestreo nucleus

Nota:

Rango de valores: [0, 1]
El modelo solo considera los tokens cuya masa de probabilidad se encuentra dentro de top_p
0.1 significa que solo se consideran el 10 % de tokens con mayor masa de probabilidad
Cuanto mayor es el valor, más aleatoria es la generación; cuanto menor, más determinista
Se recomienda ajustar solo temperature o top_p

Rango requerido: 0 <= x <= 1

Ejemplo:

0.9

stop

El modelo detiene la generación cuando encuentra alguna de las cadenas indicadas en el campo stop; esa cadena no se incluye en la salida. Se admiten hasta 4 cadenas

Nota: los modelos de pensamiento profundo no admiten este campo

Ejemplo:

["你好", "天气"]

reasoning_effort

enum<string> | null

predeterminado:medium

Limita el esfuerzo de pensamiento; reducir la profundidad mejora la velocidad y consume menos tokens

minimal: pensamiento desactivado, respuesta directa
low: pensamiento ligero, prioriza la respuesta rápida
medium: modo equilibrado, entre velocidad y profundidad
high: análisis profundo, para problemas complejos

Opciones disponibles:

minimal,

low,

medium,

high

Ejemplo:

"medium"

response_format

object

Especifica el formato de respuesta del modelo

Admite tres formatos: text (predeterminado), json_object, json_schema

Show child attributes

frequency_penalty

number | null

predeterminado:0

Coeficiente de penalización por frecuencia

Nota:

Rango de valores: [-2.0, 2.0]
Los valores positivos penalizan los nuevos tokens según su frecuencia en el texto generado hasta el momento, lo que reduce la probabilidad de que el modelo repita literalmente

Rango requerido: -2 <= x <= 2

Ejemplo:

0

presence_penalty

number | null

predeterminado:0

Coeficiente de penalización por presencia

Nota:

Rango de valores: [-2.0, 2.0]
Los valores positivos penalizan los nuevos tokens según si ya han aparecido en el texto, lo que aumenta la probabilidad de que el modelo hable de temas nuevos

Rango requerido: -2 <= x <= 2

Ejemplo:

0

logprobs

boolean | null

predeterminado:false

Indica si se devuelven las probabilidades logarítmicas de los tokens de salida

false: no devolver información de probabilidad logarítmica
true: devolver la probabilidad logarítmica de cada token de salida del contenido del mensaje

Nota: los modelos de pensamiento profundo no admiten este campo

top_logprobs

integer | null

predeterminado:0

Indica el número de tokens más probables que se devuelven en cada posición de token de salida, cada uno con su probabilidad logarítmica asociada

Rango de valores: [0, 20]
Solo puede establecerse cuando logprobs es true

Nota: los modelos de pensamiento profundo no admiten este campo

Rango requerido: 0 <= x <= 20

logit_bias

object | null

Ajusta la probabilidad de que determinados tokens aparezcan en la salida del modelo

Nota:

Acepta un map cuyas claves son los ID de token del vocabulario y cuyos valores son sesgos
Rango de los valores de sesgo: [-100, 100]
-1 reduce la probabilidad de selección y 1 la aumenta
-100 prohíbe por completo la selección del token y 100 hace que solo ese token pueda seleccionarse

Nota: los modelos de pensamiento profundo no admiten este campo

Show child attributes

tools

object[] | null

Lista de herramientas a invocar; la respuesta del modelo puede incluir solicitudes de llamada a herramientas

Show child attributes

parallel_tool_calls

boolean

predeterminado:true

Indica si la respuesta del modelo puede contener varias herramientas a invocar en esta solicitud

true: se pueden devolver varias herramientas a invocar
false: el número de herramientas a invocar devueltas es <= 1

tool_choice

Indica si la respuesta del modelo debe contener herramientas a invocar en esta solicitud

Modo cadena:

none: la respuesta del modelo no contiene herramientas a invocar
required: la respuesta del modelo debe contener herramientas a invocar
auto: el modelo decide si su respuesta incluye herramientas a invocar (valor predeterminado cuando se proporcionan herramientas)

Modo objeto: especificar el alcance de las herramientas a invocar

Opciones disponibles:

none,

auto,

required

Respuesta

Chat generado con éxito

string

Identificador único de esta solicitud

Ejemplo:

"0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50"

model

string

Nombre y versión del modelo realmente utilizado en esta solicitud

Ejemplo:

"doubao-seed-2-0-pro-260215"

object

enum<string>

Tipo de respuesta, siempre chat.completion

Opciones disponibles:

chat.completion

Ejemplo:

"chat.completion"

service_tier

enum<string>

Nivel de servicio de esta solicitud

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

Opciones disponibles:

default,

scale

Ejemplo:

"default"

created

integer

Marca de tiempo Unix (en segundos) de creación de esta solicitud

Ejemplo:

1771485416

choices

object[]

Contenido de salida del modelo para esta solicitud

Show child attributes

usage

object

Consumo de tokens de esta solicitud

Show child attributes

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 - Referencia completa de API

Autorizaciones

Todas las APIs requieren autenticación Bearer Token

Cuerpo

Respuesta