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": "Veuillez vous présenter"
}
'

{
  "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": {},
  "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 - Référence API complète

Appel des modèles de la série Doubao Seed 2.0 au format Responses API
Stockage du contexte côté serveur : conversations multi-tours via previous_response_id, sans avoir à transmettre manuellement l’historique des messages
Entrée multimodale : prend en charge les entrées mixtes texte + image + vidéo + fichier (PDF)
Réflexion approfondie : prend en charge le mode chaîne de raisonnement thinking
Appel d’outils : prend en charge le Function Calling, la recherche web, le traitement d’image, les outils MCP, les bases de connaissances privées et l’assistant Doubao
Cache de contexte : prend en charge le mécanisme de cache caching pour réduire les coûts
Sortie structurée : prend en charge les formats JSON Object / JSON Schema
Gestion du contexte : prend en charge la stratégie context_management
💡 Envie de démarrer rapidement ? Consultez le guide de démarrage rapide

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": "Veuillez vous présenter"
}
'

{
  "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": {},
  "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 par défaut est https://direct.evolink.ai, qui offre une meilleure prise en charge des modèles de texte et des connexions persistantes. https://api.evolink.ai est le point d’accès principal pour les services multimodaux et sert d’adresse de secours pour les modèles de texte.

Autorisations

Authorization

string

header

requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

défaut:doubao-seed-2.0-pro

requis

Nom du modèle de conversation

doubao-seed-2.0-pro : version phare, capacités globales les plus élevées
doubao-seed-2.0-lite : version allégée, plus rapide
doubao-seed-2.0-mini : version ultra-rapide, réponse la plus rapide
doubao-seed-2.0-code : version spécialisée pour le code

Options disponibles:

doubao-seed-2.0-pro,

doubao-seed-2.0-lite,

doubao-seed-2.0-mini,

doubao-seed-2.0-code

Exemple:

"doubao-seed-2.0-pro"

input

requis

Contenu d'entrée. Deux formats sont pris en charge :

1. Chaîne de texte brut : équivalent à un texte saisi avec le rôle user

2. Liste d'éléments (array) : contient plusieurs types d'entrée, notamment messages, contexte et appels d'outils

instructions

string | null

Insère un message système ou une instruction développeur comme première instruction du contexte du modèle

Remarque :

Lorsqu'il est utilisé avec previous_response_id, les instructions de la réponse précédente ne sont pas héritées
Ne peut pas être utilisé conjointement avec la fonctionnalité de cache caching

previous_response_id

string | null

Identifiant unique de la réponse précédente du modèle, utilisé pour les conversations multi-tours

Remarque :

Lorsqu'il est fourni, l'entrée et la réponse du tour précédent sont reprises, et le nombre de tokens d'entrée de cette requête augmente en conséquence
Dans les conversations multi-tours continues, il est recommandé d'ajouter environ 100 millisecondes de délai entre chaque requête

expire_at

integer

Date d'expiration du stockage, horodatage Unix UTC (secondes)

Remarque :

Plage de valeurs : (date de création, date de création + 604800], soit une conservation maximale de 7 jours
Valeur par défaut : date de création + 259200 (3 jours)
S'applique à la fois à store et à caching
La durée de stockage du cache est facturée ; toute tranche de moins de 1 heure est comptée comme 1 heure

max_output_tokens

integer | null

Nombre maximal de tokens de sortie du modèle, incluant la réponse et la chaîne de raisonnement

Exemple:

32768

thinking

object

Contrôle si le modèle active le mode de réflexion approfondie

Show child attributes

reasoning

object

Limite l'effort de réflexion approfondie ; le réduire accélère la réponse et consomme moins de tokens

Show child attributes

caching

object

Indique s'il faut activer la mise en cache du contexte

Remarque : ne peut pas être utilisé conjointement avec le champ instructions ni avec le champ tools (hors Function Calling)

Show child attributes

store

boolean | null

défaut:true

Indique s'il faut stocker la réponse générée par le modèle afin de la récupérer ultérieurement via l'API

true : stocker la réponse actuelle du modèle
false : ne pas la stocker

stream

boolean | null

défaut:false

Indique si le contenu de la réponse est renvoyé en streaming

false : le modèle renvoie tout le contenu en une seule fois, une fois la génération terminée
true : renvoi progressif par blocs selon le protocole SSE, se terminant par un message data: [DONE]

temperature

number | null

défaut:1

Température d'échantillonnage, contrôle le caractère aléatoire de la sortie

Plage de valeurs : [0, 2]
Les valeurs basses donnent des sorties plus déterministes, les valeurs élevées plus aléatoires
Il est recommandé de n'ajuster que temperature ou top_p

Remarque : doubao-seed-2.0-pro et doubao-seed-2.0-lite sont fixés à 1 ; toute valeur indiquée manuellement est ignorée

Plage requise: 0 <= x <= 2

top_p

number | null

défaut:0.7

Seuil de probabilité de l'échantillonnage nucleus

Plage de valeurs : [0, 1]
Il est recommandé de n'ajuster que temperature ou top_p

Remarque : doubao-seed-2.0-pro et doubao-seed-2.0-lite sont fixés à 0.95 ; toute valeur indiquée manuellement est ignorée

Plage requise: 0 <= x <= 1

text

object

Définition du format de sortie du texte du modèle

Show child attributes

tools

object[]

Liste des outils que le modèle peut appeler

Types d'outils pris en charge :

function : fonction personnalisée (Function Calling)
web_search : recherche web
doubao_app : assistant Doubao
image_process : traitement d'image
mcp : outils MCP
knowledge_search : recherche dans une base de connaissances privée

Show child attributes

tool_choice

Contrôle si le modèle appelle des outils

Mode chaîne :

none : ne pas appeler d'outils
required : doit appeler un outil
auto : le modèle décide (par défaut)

Mode objet : indiquer un outil précis à appeler

Options disponibles:

none,

auto,

required

max_tool_calls

integer

Nombre maximal de tours d'appels d'outils (nombre d'appels illimité par tour)

Plage de valeurs : [1, 10]
Web Search : 3 par défaut
Image Process : 10 par défaut (non modifiable)
Knowledge Search : 3 par défaut

Remarque : ce paramètre fonctionne au mieux des possibilités ; le nombre réel d'appels dépend notamment de la qualité du raisonnement du modèle

Plage requise: 1 <= x <= 10

context_management

object

Stratégie de gestion du contexte, qui aide le modèle à exploiter efficacement la fenêtre de contexte

Show child attributes

Réponse

Réponse générée avec succès

string

Identifiant unique de cette réponse

Exemple:

"resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e"

object

enum<string>

Type d'objet, valeur fixe response

Options disponibles:

response

Exemple:

"response"

created_at

number

Horodatage Unix de création (secondes)

Exemple:

1771486674

model

string

Nom et version du modèle réellement utilisé

Exemple:

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

status

enum<string>

Statut de la réponse

completed : génération terminée
in_progress : génération en cours
incomplete : incomplète
failed : échec

Options disponibles:

completed,

in_progress,

incomplete,

failed

Exemple:

"completed"

output

(Sortie de la chaîne de raisonnement · object | Sortie de message · object | Sortie de l'appel d'outil · object)[]

Liste des contenus de sortie du modèle : sortie de la chaîne de raisonnement, sortie de message, sortie d'appel d'outil, etc.

Sortie de la chaîne de raisonnement
Sortie de message
Sortie de l'appel d'outil

Show child attributes

service_tier

string

Niveau de service de cette requête

default : niveau de service par défaut
scale : quota du forfait garanti utilisé

Exemple:

"default"

instructions

string | null

Instructions système utilisées pour cette requête

previous_response_id

string | null

ID de la réponse précédente référencée

max_output_tokens

integer

Nombre maximal de tokens de sortie du modèle

Exemple:

32768

temperature

number | null

Température d'échantillonnage utilisée

top_p

number | null

Valeur top_p utilisée

thinking

object | null

Configuration du mode de réflexion utilisée

tools

array | null

Liste des outils utilisés

tool_choice

any | null

Configuration de sélection d'outils utilisée

parallel_tool_calls

boolean | null

Indique si les appels d'outils en parallèle sont autorisés

text

object | null

Configuration du format de sortie du texte

usage

object

Statistiques d'utilisation des jetons

Show child attributes

caching

object

Configuration du cache

Show child attributes

store

boolean

Indique si la réponse a été stockée

expire_at

integer

Date d'expiration du stockage (horodatage Unix)

Exemple:

1756539922

error

object | null

Informations d'erreur, null en cas de succès

incomplete_details

object | null

Raison détaillée de l'inachèvement

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Doubao Seed 2.0 Responses API - Référence API complète

Autorisations

Corps

Réponse