Famille Doubao Seed

Les modèles de texte Doubao Seed de ByteDance, qui comprennent Seed 2.1 Pro, Seed 2.1 Turbo, Seed Evolving et Seed Character. Ils s’appellent via l’API compatible OpenAI ; tous sauf Seed Character prennent aussi en charge l’API native Anthropic et s’utilisent dans Claude Code. Les modèles de génération d’images de Doubao sont présentés dans Seedream (Doubao), et les modèles vidéo dans Seedance.

Tâches courantes

Modèles

La liste complète des modèles et les prix en vigueur figurent sur la page des modèles . Le préfixe des ID de modèle est volcengine/, et il est facultatif ; les préfixes bytedance/ ou doubao/, ou les noms de modèle datés de Volcano Engine Ark, renvoient 404.

Ces modèles sont servis par Volcano Engine (volcengine) et prennent tous en charge les endpoints Chat Completions et Responses.

Exemples d’appel

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": "Explique en une phrase ce qu’est l’idempotence."}],
    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": "Explique en une phrase ce qu’est l’idempotence."}],
    "thinking": {"type": "disabled"}
  }'

Deep thinking

• thinking.type accepte enabled et disabled ; passer auto renvoie 400.
• Lors de nos tests avec « Explique en une phrase ce qu’est l’idempotence » : Seed 2.1 Pro a produit par défaut environ 1500 tokens de thinking en environ 40 secondes, Seed Evolving environ 1700 tokens en environ 54 secondes. Thinking désactivé, la réponse arrive en environ 2 secondes.
• Les tokens de thinking sont comptés dans max_tokens. Si la limite est trop basse, content peut être vide, avec finish_reason égal à length.
• Les tokens de thinking sont facturés au prix unitaire de sortie ; leur nombre figure dans usage.completion_tokens_details.reasoning_tokens.

Lire le contenu du thinking : dans une réponse streamée, il se trouve dans delta.reasoning_content ; dans une réponse non streamée, dans message.reasoning_details, dont il faut concaténer le text de chaque élément dans l’ordre.

Utiliser avec Claude Code

Seed 2.1 Pro, Seed 2.1 Turbo et Seed Evolving prennent en charge l’API native Anthropic, à l’adresse https://api.ofox.ai/anthropic :

• Via l’API Anthropic, aucun contenu de thinking n’est renvoyé si le paramètre thinking est omis. Pour obtenir le thinking, passez "thinking": {"type": "enabled", "budget_tokens": 2000} ou {"type": "adaptive"} : le contenu du thinking est alors renvoyé dans des blocs thinking.
• Seed Character ne prend pas en charge l’API Anthropic ; l’appel renvoie protocol_not_supported.

Les étapes complètes de configuration de Claude Code sont décrites dans Configuration de Claude Code.

Images en entrée et sortie structurée

• Images en entrée : tous ces modèles acceptent les images en entrée, avec le bloc de contenu standard image_url ; voir Compréhension visuelle. L’URL de l’image doit pouvoir être téléchargée rapidement depuis Internet, sinon la requête renvoie Timeout while downloading url ; vous pouvez aussi utiliser des données base64.
• Sortie structurée : response_format accepte json_schema et json_object ; voir Sortie structurée.
• Appel d’outils : utilise le paramètre standard tools et renvoie tool_calls.

Erreurs courantes

Les autres erreurs générales sont décrites dans Gestion des erreurs.

Documentation officielle

• Volcano Engine Ark · Documentation 

FAQ