API de Doubao fuera de China: Seed, Seedream y Seedance

Q: ¿Por qué doubao-seed-2-1-pro-260915 ignora tool_choice?

Ese modelo y doubao-seed-evolving eligen las herramientas por su cuenta, aunque indiques none o nombres una función. Usa doubao-seed-2-1-pro-260628 o doubao-seed-2-1-lite-260915 cuando necesites forzar o desactivar las llamadas a herramientas.

Respuesta corta: puedes llamar a los modelos de chat Doubao Seed de ByteDance, a los modelos de imagen Seedream, a los de video Seedance y a Doubao Speech desde fuera de China con una sola clave de HopBase y el SDK de OpenAI. Configura base_url como https://api.hop-base.com/v1, añade a la clave en la consola los grupos que necesites y usa los IDs de modelo exactos que devuelve GET /v1/models. Por ejemplo, doubao-seed-2-1-pro-260628 para chat, seedream-5-0-pro para imágenes, dreamina-seedance-2-5-260628 para video y seed-tts-2.0 para voz. El chat funciona con Chat Completions, Responses y Anthropic Messages. Las imágenes son síncronas en /v1/images/generations. El video es una tarea asíncrona que envías y luego consultas. Te registras con un email o con una cuenta de Google o GitHub, y pagas por uso en USD con tarjeta, Apple Pay, Google Pay, Alipay, AlipayHK o WeChat Pay. Los precios de lista oficiales están en la página de precios.

Qué abarca «Doubao» y qué grupo lo sirve

ByteDance publica varias líneas de modelos bajo los nombres Doubao y Seed. En HopBase cada línea tiene su propio grupo, y una clave puede incluir hasta 10 grupos:

Línea de producto	Para qué sirve	Grupo en la consola	IDs de modelo
Chat Doubao Seed	Chat con texto e imágenes, llamadas a herramientas, razonamiento	Doubao Seed en la nube	`doubao-seed-2-1-pro-260628`, `doubao-seed-2-1-pro-260915`, `doubao-seed-2-1-lite-260915`, `doubao-seed-2-1-turbo-260628`, `doubao-seed-evolving`, `doubao-seed-character-260628`, `doubao-seed-2-0-mini-260428`
Seedream	Texto a imagen, imagen a imagen, edición	Generación de imágenes Seedream, o Seedance internacional + Seedream (este solo tiene `seedream-5-0-pro`)	`seedream-5-0-pro`, `seedream-5-0-lite`, `seedream-4-5`
Seedance (IDs internacionales)	Video a partir de texto, imagen o referencias	Seedance internacional + Seedream	`dreamina-seedance-2-5-260628`, `dreamina-seedance-2-0-260128`, `dreamina-seedance-2-0-fast-260128`, `dreamina-seedance-2-0-mini-260615`
Seedance (IDs de China)	Las mismas familias, IDs de China	Seedance China (Doubao)	`doubao-seedance-2-5-260628-a`, `doubao-seedance-2-0-260128-a`, `doubao-seedance-2-0-fast-260128-a`, `doubao-seedance-2-0-mini-260615-a`
Doubao Speech	Texto a voz, audio de escena, clonación de voz	Doubao Voz en la nube	`seed-tts-2.0`, `seed-audio-1.0`, `seed-icl-2.0`

No confundas doubao-seed-* (chat) con doubao-seedance-* (video): son grupos distintos. Los IDs de modelo se comparan de forma exacta: cópialos de GET /v1/models y no los acortes ni les añadas sufijos.

Paso 1: crea una clave y lista sus modelos

Regístrate en api.hop-base.com, abre Claves API, crea una clave y añade los grupos de la tabla anterior. Después comprueba a qué puede llegar la clave:

export HOPBASE_API_KEY=sk-your-key
curl https://api.hop-base.com/v1/models \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

Chat Doubao Seed con el SDK de OpenAI

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.hop-base.com/v1",
    api_key=os.environ["HOPBASE_API_KEY"],
)

resp = client.chat.completions.create(
    model="doubao-seed-2-1-pro-260628",
    messages=[{"role": "user", "content": "Summarise the main idea of retrieval-augmented generation in two sentences."}],
    max_tokens=4000,
)
print(resp.choices[0].message.content)

Lo que debes saber antes de pasar a producción:

Contexto y salida. doubao-seed-2-1-pro-260915 y doubao-seed-2-1-lite-260915 tienen un contexto de 1M tokens y hasta 256K de salida. doubao-seed-2-1-pro-260628, doubao-seed-2-1-turbo-260628, doubao-seed-evolving y doubao-seed-2-0-mini-260428 tienen un contexto de 256K y hasta 128K de salida. doubao-seed-character-260628 tiene un contexto de 128K y hasta 32K de salida.
Razonamiento. Todos los modelos salvo doubao-seed-character-260628 razonan por defecto y devuelven el razonamiento en reasoning_content. El razonamiento cuenta dentro de max_tokens, así que deja margen.
Imágenes. Los siete modelos aceptan partes de contenido image_url como URL pública o como URI data: (base64). Usa base64 para enlaces privados.
Herramientas. Los siete admiten llamadas a herramientas. doubao-seed-evolving y doubao-seed-2-1-pro-260915 ignoran tool_choice. Para forzar o desactivar las llamadas a herramientas, usa doubao-seed-2-1-pro-260628 o doubao-seed-2-1-lite-260915.
No admitido. logprobs no está disponible en doubao-seed-2-1-pro-260915 ni en doubao-seed-2-1-lite-260915.
Otros protocolos. Los mismos modelos funcionan en POST /v1/responses y en Anthropic Messages (base_url="https://api.hop-base.com", sin /v1).
Uso en streaming. Envía stream_options={"include_usage": True} para recibir el uso dentro del stream. Los aciertos de la caché de contexto se cobran al precio de entrada en caché.

Tablas completas de parámetros: Crear chat completion: Doubao Seed y la ficha del modelo.

Imágenes Seedream con el SDK de OpenAI

Seedream es síncrono: la respuesta contiene el enlace a la imagen. No hay ninguna tarea que consultar.

img = client.images.generate(
    model="seedream-5-0-pro",
    prompt="A ceramic coffee cup on a linen tablecloth, soft morning light, product photo",
    size="2K",
)
print(img.data[0].url)  # signed link, valid 24 hours: download it

Tamaños. seedream-5-0-pro acepta 1K, 1.5K o 2K, o ANCHOxALTO entre 921.600 y 4.624.220 píxeles. En Pro, 1.5K cuesta lo mismo que 1K y da más calidad. seedream-5-0-lite (2K / 3K / 4K) y seedream-4-5 (2K / 4K) generan como mínimo 2K.
Referencias y ediciones. Pon las imágenes de referencia en image (una URL o Data URL, como cadena o array). Pro admite hasta 10 referencias; Lite y 4.5, hasta 14. No hay máscara: describe en el prompt la zona que quieres editar.
n es siempre 1. Para obtener una serie de imágenes, usa la generación en grupo en Lite o 4.5.

Consulta Seedream para la descomposición en capas, los fondos transparentes y el streaming.

Video Seedance: enviar y luego consultar

import os, time, requests

API = "https://api.hop-base.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['HOPBASE_API_KEY']}"}

task = requests.post(f"{API}/video/generate", headers=HEADERS, json={
    "model": "dreamina-seedance-2-5-260628",
    "content": [{"type": "text", "text": "An orange cat runs across sunlit grass as the camera follows"}],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
}).json()["task"]

while True:
    t = requests.get(f"{API}/video/tasks/{task['id']}", headers=HEADERS).json()["task"]
    if t["status"] == "completed":
        print(t["outputs"][0]); break   # valid 24 hours after completion
    if t["status"] == "failed":
        raise RuntimeError(t["error"]["message"])
    time.sleep(5)

¿Qué IDs? Las claves internacionales dreamina-seedance-* no pueden llamar a los IDs doubao-seedance-*. El grupo de China también acepta los IDs internacionales como alias (salvo 4K), así que pasar de internacional a China solo implica cambiar la clave. 4K solo está disponible en 2.0 Standard internacional (dreamina-seedance-2-0-260128).
Duraciones. 2.0: de 4 a 15 segundos; 2.5: de 4 a 30 segundos, o -1 para que decida el modelo.
Campos. Todos los campos van en el nivel superior del JSON, y el prompt va en un elemento text de content. size, seconds, n y aspect_ratio se ignoran sin aviso: usa duration, resolution y ratio.
Facturación. Las tareas fallidas no se cobran. Nunca reenvíes una tarea que ya fue aceptada, porque cada envío se cobra por separado.

Detalles: API de generación de video Seedance y Seedance API pricing explained (en inglés).

Doubao Speech: texto a voz y clonación de voz

speech = client.audio.speech.create(
    model="seed-tts-2.0",
    voice="alloy",   # an OpenAI voice name picks the default voice for the text language
    input="Hello, welcome to Doubao text to speech.",
)
speech.write_to_file("hello.mp3")

seed-tts-2.0 admite hasta 5.000 caracteres y genera audio mono a 24 kHz. También puedes pasar un ID de voz de Doubao como en_female_dacey_uranus_bigtts.
seed-audio-1.0 crea audio con tono y efectos de sonido a partir de una descripción de escena más diálogos (hasta 3.000 caracteres, estéreo a 48 kHz).
seed-icl-2.0 habla con una voz que primero clonas con POST /v1/voice_clone.
Usa solo POST /v1/audio/speech. Devuelve el clip completo de una vez y no hace streaming.

La documentación indica precios oficiales de ¥3 por cada 10.000 caracteres para seed-tts-2.0 y seed-icl-2.0, y ¥1 por minuto de audio generado para seed-audio-1.0. Se cobran de tu saldo en USD tras la conversión. La clonación en sí es gratuita por ahora. Consulta API de texto a voz: Doubao Speech.

Precios

Los precios de lista oficiales de todos los modelos Doubao Seed, Seedream y Seedance están en la página de precios. ByteDance publica algunos de estos precios en CNY; HopBase los convierte a USD y los cobra de tu saldo en USD. Algunas reglas de facturación que conviene tener en cuenta:

Doubao Seed Character y 2.0 Mini se cobran por tramos de longitud de entrada. Cuando la entrada de una solicitud, incluidos los aciertos de caché, supera un umbral, toda la solicitud se cobra en ese tramo. Los otros cinco modelos de chat tienen un único tramo y no hay precios de hora punta o valle.
Seedream se cobra por imagen generada, y Seedance por millón de tokens de video.
Cada respuesta no streaming facturada y cada tarea terminada indican el cargo exacto en USD en usage.cost_usd.

Lecturas relacionadas

Preguntas frecuentes

¿Puedo usar la API de Doubao sin un número de teléfono chino ni una empresa china?

Sí. Te registras en api.hop-base.com con un email o con una cuenta de Google o GitHub. La facturación es en USD y puedes pagar con Visa / Mastercard, Apple Pay, Google Pay, Alipay, AlipayHK o WeChat Pay.

¿La API de Doubao en HopBase es compatible con OpenAI?

Sí. El chat Doubao Seed funciona con Chat Completions y Responses en https://api.hop-base.com/v1, y con Anthropic Messages en https://api.hop-base.com. Seedream usa los endpoints de imágenes de OpenAI y Doubao Speech usa el endpoint de voz de OpenAI. Seedance usa la API de tareas de video de HopBase.

¿Qué diferencia hay entre los IDs `doubao-seedance--a` y `dreamina-seedance-`?

Son los IDs de China e internacionales de las mismas familias Seedance, servidos por dos grupos distintos. Las claves internacionales solo llegan a dreamina-seedance-*. Las claves de China llegan a doubao-seedance-*-a y también aceptan los IDs internacionales como alias. 4K solo existe en 2.0 Standard internacional.

¿Por qué `doubao-seed-2-1-pro-260915` ignora `tool_choice`?

Ese modelo y doubao-seed-evolving eligen las herramientas por su cuenta, aunque indiques none o nombres una función. Usa doubao-seed-2-1-pro-260628 o doubao-seed-2-1-lite-260915 cuando necesites forzar o desactivar las llamadas a herramientas.

¿Una sola clave puede llamar a Doubao y a Claude o GPT?

Sí. Añade a la misma clave el grupo Doubao Seed en la nube más un grupo de Claude y uno de GPT (hasta 10 grupos). Claude usa el SDK de Anthropic en https://api.hop-base.com, y GPT y Doubao usan el SDK de OpenAI en https://api.hop-base.com/v1.

¿Cuánto duran los enlaces de imágenes y videos?

Los enlaces de imágenes de Seedream y los enlaces de resultados de Seedance son válidos durante 24 horas. Descárgalos o cópialos a tu propio almacenamiento.