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

{
  "id": "0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50",
  "model": "doubao-seed-2-0-pro-260215",
  "object": "chat.completion",
  "service_tier": "default",
  "created": 1771485416,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！Doubao Seed 2.0 是字节跳动推出的新一代大语言模型，具备更强的推理、多模态理解和深度思考能力。",
        "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 - Référence API complète

Appel des modèles de la série Doubao Seed 2.0 au format OpenAI SDK
Mode de traitement synchrone, renvoi du contenu de la conversation en temps réel
Conversation en texte brut : conversation contextuelle sur un ou plusieurs tours
Invite système : personnalisez le rôle et le comportement de l’IA
Entrée multimodale : prend en charge les entrées mixtes texte + image + vidéo
Réflexion approfondie : prend en charge le mode chaîne de raisonnement pour un raisonnement approfondi
Appel d’outils : prend en charge le Function Calling
Sortie structurée : prend en charge les formats JSON Object / JSON Schema
Envie de démarrer rapidement ? Consultez le guide de démarrage rapide

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

{
  "id": "0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50",
  "model": "doubao-seed-2-0-pro-260215",
  "object": "chat.completion",
  "service_tier": "default",
  "created": 1771485416,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！Doubao Seed 2.0 是字节跳动推出的新一代大语言模型，具备更强的推理、多模态理解和深度思考能力。",
        "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 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, adaptée au raisonnement complexe et à la génération de haute qualité
doubao-seed-2.0-lite : version allégée, plus rapide, bon rapport qualité-prix
doubao-seed-2.0-mini : version ultra-rapide, réponse la plus rapide, adaptée aux tâches simples
doubao-seed-2.0-code : version spécialisée pour le code, optimisée pour la génération et la compréhension de 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"

messages

object[]

requis

Liste des messages de la conversation ; prend en charge les conversations multi-tours et les entrées multimodales (texte, image, vidéo)

Minimum array length: 1

Show child attributes

thinking

object

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

La prise en charge et les valeurs par défaut varient selon les modèles

Show child attributes

stream

boolean

défaut:false

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

false : le modèle renvoie le résultat en une seule fois, une fois tout le contenu généré
true : le contenu généré par le modèle est renvoyé par blocs selon le protocole SSE et se termine par un message data: [DONE]. Lorsque stream vaut true, le champ stream_options permet d'obtenir les statistiques de consommation de tokens

Exemple:

false

stream_options

object | null

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

Show child attributes

max_tokens

integer | null

défaut:4096

Longueur maximale de la réponse du modèle (en tokens)

Remarque :

La réponse du modèle n'inclut pas la chaîne de raisonnement (réponse du modèle = sortie du modèle - chaîne de raisonnement)
La longueur totale des tokens de sortie est également limitée par la longueur de contexte du modèle
Ne peut pas être défini en même temps que max_completion_tokens

Exemple:

4096

max_completion_tokens

integer | null

Contrôle la longueur maximale de sortie du modèle, réponse et chaîne de raisonnement comprises (en tokens)

Remarque :

Plage de valeurs : [0, 65536]
Une fois défini, la valeur par défaut de max_tokens n'est plus appliquée : le modèle produit le contenu nécessaire (réponse et chaîne de raisonnement) jusqu'à atteindre cette valeur
Ne peut pas être défini en même temps que max_tokens
Recommandé lorsque le mode de réflexion approfondie est activé

Plage requise: 0 <= x <= 65536

Exemple:

16384

temperature

number | null

défaut:1

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

Remarque :

Plage de valeurs : [0, 2]
Valeurs basses (par ex. 0.2) : sortie plus déterministe et plus ciblée
Valeurs élevées (par ex. 0.8) : sortie plus aléatoire et plus créative
Avec la valeur 0, le modèle ne retient que le token dont la log-probabilité est la plus élevée
Il est recommandé de n'ajuster que temperature ou top_p

Plage requise: 0 <= x <= 2

Exemple:

0.7

top_p

number | null

défaut:0.7

Seuil de probabilité de l'échantillonnage nucleus

Remarque :

Plage de valeurs : [0, 1]
Le modèle ne considère que les tokens dont la masse de probabilité se situe dans top_p
0.1 signifie que seuls les 10 % de tokens ayant la plus forte masse de probabilité sont pris en compte
Plus la valeur est élevée, plus la génération est aléatoire ; plus elle est basse, plus elle est déterministe
Il est recommandé de n'ajuster que temperature ou top_p

Plage requise: 0 <= x <= 1

Exemple:

0.9

stop

Le modèle arrête la génération lorsqu'il rencontre l'une des chaînes indiquées dans le champ stop ; cette chaîne elle-même n'est pas restituée. Jusqu'à 4 chaînes sont prises en charge

Remarque : les modèles à réflexion approfondie ne prennent pas en charge ce champ

Exemple:

["你好", "天气"]

reasoning_effort

enum<string> | null

défaut:medium

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

minimal : réflexion désactivée, réponse directe
low : réflexion légère, priorité à la rapidité
medium : mode équilibré, entre rapidité et profondeur
high : analyse approfondie, pour les problèmes complexes

Options disponibles:

minimal,

low,

medium,

high

Exemple:

"medium"

response_format

object

Spécifie le format de réponse du modèle

Trois formats sont pris en charge : text (par défaut), json_object, json_schema

Show child attributes

frequency_penalty

number | null

défaut:0

Coefficient de pénalité de fréquence

Remarque :

Plage de valeurs : [-2.0, 2.0]
Les valeurs positives pénalisent les nouveaux tokens en fonction de leur fréquence dans le texte déjà généré, ce qui réduit la probabilité que le modèle répète mot pour mot

Plage requise: -2 <= x <= 2

Exemple:

0

presence_penalty

number | null

défaut:0

Coefficient de pénalité de présence

Remarque :

Plage de valeurs : [-2.0, 2.0]
Les valeurs positives pénalisent les nouveaux tokens selon qu'ils sont déjà apparus ou non dans le texte, ce qui augmente la probabilité que le modèle aborde de nouveaux sujets

Plage requise: -2 <= x <= 2

Exemple:

0

logprobs

boolean | null

défaut:false

Indique s'il faut renvoyer les log-probabilités des tokens de sortie

false : ne pas renvoyer les informations de log-probabilité
true : renvoyer la log-probabilité de chaque token de sortie du contenu du message

Remarque : les modèles à réflexion approfondie ne prennent pas en charge ce champ

top_logprobs

integer | null

défaut:0

Indique le nombre de tokens les plus probables à renvoyer à chaque position de token de sortie, chacun accompagné de sa log-probabilité

Plage de valeurs : [0, 20]
Ne peut être défini que si logprobs vaut true

Remarque : les modèles à réflexion approfondie ne prennent pas en charge ce champ

Plage requise: 0 <= x <= 20

logit_bias

object | null

Ajuste la probabilité d'apparition de tokens donnés dans la sortie du modèle

Remarque :

Accepte une map dont les clés sont les ID de tokens du vocabulaire et les valeurs des biais
Plage des valeurs de biais : [-100, 100]
-1 réduit la probabilité de sélection, 1 l'augmente
-100 interdit complètement la sélection du token, 100 fait que seul ce token peut être sélectionné

Remarque : les modèles à réflexion approfondie ne prennent pas en charge ce champ

Show child attributes

tools

object[] | null

Liste des outils à appeler ; la réponse du modèle peut contenir des demandes d'appel d'outils

Show child attributes

parallel_tool_calls

boolean

défaut:true

Indique si la réponse du modèle peut contenir plusieurs outils à appeler pour cette requête

true : plusieurs outils à appeler peuvent être renvoyés
false : le nombre d'outils à appeler renvoyés est <= 1

tool_choice

Indique si la réponse du modèle doit contenir des outils à appeler pour cette requête

Mode chaîne :

none : la réponse du modèle ne contient pas d'outils à appeler
required : la réponse du modèle doit contenir des outils à appeler
auto : le modèle décide si sa réponse contient des outils à appeler (valeur par défaut lorsque des outils sont fournis)

Mode objet : indiquer le périmètre des outils à appeler

Options disponibles:

none,

auto,

required

Réponse

Génération de chat réussie

string

Identifiant unique de cette requête

Exemple:

"0217714854126607f5a9cf8ed5b018c76e4ad3dc2810db57ffb50"

model

string

Nom et version du modèle réellement utilisé pour cette requête

Exemple:

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

object

enum<string>

Type de réponse, toujours chat.completion

Options disponibles:

chat.completion

Exemple:

"chat.completion"

service_tier

enum<string>

Niveau de service de cette requête

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

Options disponibles:

default,

scale

Exemple:

"default"

created

integer

Horodatage Unix (en secondes) de création de cette requête

Exemple:

1771485416

choices

object[]

Contenu de sortie du modèle pour cette requête

Show child attributes

usage

object

Consommation de tokens pour cette requête

Show child attributes

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 - Référence API complète

Autorisations

Corps

Réponse