Familia Doubao Seed

Los modelos de texto Doubao Seed de ByteDance, que incluyen Seed 2.1 Pro, Seed 2.1 Turbo, Seed Evolving y Seed Character. Se llaman a través de la API compatible con OpenAI y, salvo Seed Character, también admiten el endpoint nativo de Anthropic, por lo que pueden usarse en Claude Code. Los modelos de generación de imágenes de Doubao están en Seedream (Doubao), y los de vídeo, en Seedance.

Tareas habituales

Modelos

La lista completa de modelos y los precios en tiempo real están en la página de modelos . El prefijo del ID de modelo es volcengine/ y puede omitirse; usar los prefijos bytedance/ o doubao/, o los nombres de modelo con fecha de Volcano Engine Ark, devuelve 404.

Estos modelos los ofrece Volcano Engine (volcengine), y todos admiten los endpoints Chat Completions y Responses.

Ejemplos de llamada

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="volcengine/doubao-seed-2.1-pro",
    messages=[{"role": "user", "content": "Explica en una frase qué es la idempotencia."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volcengine/doubao-seed-2.1-pro",
    "messages": [{"role": "user", "content": "Explica en una frase qué es la idempotencia."}],
    "thinking": {"type": "disabled"}
  }'

Thinking profundo

• thinking.type admite enabled y disabled; enviar auto devuelve 400.
• En nuestras mediciones con «Explica en una frase qué es la idempotencia.», Seed 2.1 Pro pensó por defecto unos 1500 tokens y tardó unos 40 segundos; Seed Evolving, unos 1700 tokens y unos 54 segundos. Con el thinking desactivado, la respuesta llegó en unos 2 segundos.
• Los tokens de thinking se cuentan en max_tokens. Si el límite es demasiado bajo, content puede quedar vacío, con finish_reason igual a length.
• Los tokens de thinking se facturan al precio de salida; su número figura en usage.completion_tokens_details.reasoning_tokens.

Leer el contenido del thinking: en las respuestas en streaming está en delta.reasoning_content; en las respuestas sin streaming, en message.reasoning_details: concatene por orden el text de cada elemento.

Uso en Claude Code

Seed 2.1 Pro, Seed 2.1 Turbo y Seed Evolving admiten el endpoint nativo de Anthropic, con la URL https://api.ofox.ai/anthropic:

• Al llamar a través del endpoint de Anthropic, si no se envía el parámetro thinking, no se devuelve contenido de thinking. Si necesita thinking, envíe "thinking": {"type": "enabled", "budget_tokens": 2000} o {"type": "adaptive"}; el contenido del thinking se devuelve en bloques thinking.
• Seed Character no admite el endpoint de Anthropic; la llamada devuelve protocol_not_supported.

Los pasos completos de configuración de Claude Code están en Configuración de Claude Code.

Entrada de imágenes y salida estructurada

• Entrada de imágenes: todos estos modelos admiten entrada de imágenes mediante el bloque de contenido estándar image_url; consulte Comprensión visual. El enlace de la imagen debe poder descargarse rápidamente desde Internet; de lo contrario, se devuelve Timeout while downloading url. También puede enviar los datos en base64.
• Salida estructurada: response_format admite json_schema y json_object; consulte Salida estructurada.
• Llamadas a herramientas: use el parámetro estándar tools; se devuelve tool_calls.

Errores habituales

Otros errores generales: Gestión de errores.

Documentación oficial

• Volcano Engine Ark · Documentación 

Preguntas frecuentes