Différences de paramètres et de protocoles de Doubao

Découvrez les différences de paramètres et l’utilisation de Doubao avec les protocoles compatibles.

Pour Doubao, adaptez les paramètres selon cette page. Structures complètes : Chat Completions, Responses et Messages.

Modèles concernés

Modèle	Portée
doubao-seed-2-1-lite-260915, doubao-seed-evolving, doubao-seed-2-1-pro-260915	Tous acceptent Chat, Responses, Messages ; règles communes de raisonnement et outils, audio limité à Lite
doubao-seed-evolving	ID mis à jour continuellement, différent d’une version Pro datée ; configuration stable dans une même Session

Différences Chat Completions

Champ	Différence
`thinking.type`	Accepte `enabled/disabled`, raisonnement actif par défaut
`reasoning_effort`	Défaut `high` ; niveaux effectifs `low/medium/high`, `minimal` désactive. Correspondances : `none` vers `minimal`, `xhigh/max` vers `high`
`max_tokens`	Défaut `4096`, limite la réponse sans pensée ; pas un budget combiné
`max_completion_tokens`	Inclut pensée et réponse ; plage Chat officielle `1～65536`, incompatible avec `max_tokens`. Ne pas reprendre ici le maximum annoncé du modèle
`temperature`, `top_p`	Plages `[0,2]`, `[0,1]` ; pas de température fixée à `1` comme sur certaines anciennes versions Seed 2.0
`frequency_penalty`, `presence_penalty`	Non pris en charge sur Seed 2.0 et suivants ; limite de capacité, pas dépréciation officielle
`stop`, `logprobs`	Non pris en charge par défaut sur les modèles à raisonnement approfondi ; aucun de ces trois n’est une exception officielle
`reasoning_content`, `encrypted_content`	Résumé et pensée originale chiffrée renvoyés par défaut. Pour les outils, renvoyer `encrypted_content` inchangé ; le résumé ne le remplace pas. Le chiffré prévaut si les deux sont transmis
`stream_options.chunk_include_usage`	Défaut `false` ; `true` renvoie l’usage cumulé par bloc. Ne pas additionner à nouveau les cumuls
`stream_options.include_usage`	Contrôle le bloc d’usage total final ; Lite le renvoie par défaut, autres modèles sur activation. Usage cumulé par bloc et total final sont deux réglages
`response_format`	Accepte `json_object/json_schema`, avec statut Beta officiel ; `strict: true` contraint le sous-ensemble Schema pris en charge, pas tous les mots-clés JSON Schema

Différences Responses

Champ	Différence
`reasoning.effort`	Utilise `minimal/low/medium/high` et les correspondances, défaut identique à Chat ; pas à la racine
`max_output_tokens`	Inclut pensée et réponse ; ne pas reprendre le budget réponse seule ou les limites Chat
`text.format`	JSON Schema dans `text.format` avec `name/schema/strict`, pas l’imbrication Qwen `text.format.json_schema`
`store`, `previous_response_id`	`store` : défaut `true` ; ID réel pour prolonger historique et pensée originale. `instructions` précédent non hérité automatiquement
Renvoi manuel de l’historique	Sans ID, renvoyer tous les éléments reasoning, messages et appels ; ne pas remplacer le chiffré par un résumé
`max_tool_calls`	Plage `1～10` ; limite les tours d’outils intégrés, pas les appels dans un tour. Limite indicative, pas plafond absolu de fonctions
`service_tier`, `store`	En mode natif `flex`, `store` doit être `false` ; pas de stockage serveur simultané

Différences Messages

Champ	Différence
`max_tokens`	Facultatif selon le fournisseur, contrairement à Claude ; exemples avec budget explicite
`output_config.effort`	Contrôle l’effort selon défauts et correspondances du modèle ; ne pas déplacer le champ racine Chat
`output_format`	Extension racine acceptant `text/json_object/json_schema` ; Schema dans `output_format.schema`, pas `output_config.format` de Claude
`temperature`, `top_p`	Plages `[0,2]`, `[0,1]`, y compris `top_p: 0` valide
`stop_sequences`	Le champ général accepte chaîne ou tableau, mais les modèles à raisonnement profond ne le prennent pas en charge par défaut. Sa présence ne garantit pas l’arrêt
Blocs thinking précédents	Renvoyer entièrement `thinking`, `signature` réels, sans modifier valeurs ni ordre ; ne pas générer de signature ou reconstruire par résumé

Différences de cache

Champ	Différence
Cache implicite	Automatique et non désactivable dans Chat / Responses ; au moins `1024 Token` de préfixe identique, sans garantie de hit
`prompt_cache_key`	Indice de routage Chat / Responses, stable par conversation ; même clé ne garantit ni instance fixe ni hit
Responses `caching`	Cache explicite natif activé par `type: "enabled"` ; `prefix: true` écrit le préfixe sans réponse, `false` génère et écrit normalement
Restrictions de combinaison de `caching`	Incompatible avec `instructions` ou `tools` hors Function ; pas de TTL ou Header Session d’un autre fournisseur
Utilisation du cache	Chat : `usage.prompt_tokens_details.cached_tokens` ; Responses : `usage.input_tokens_details.cached_tokens` ; Messages : `usage.cache_read_input_tokens`, `usage.cache_creation_input_tokens` réellement renvoyés

Différences d’entrée multimédia

Entrée	Bloc du protocole	Différence
Image	`image_url`	Chat : URL publique / Base64 Data URL dans `image_url.url`, précision dans `image_url.detail`
Vidéo	`video_url`	Chat : vidéo dans `video_url.url` ; `fps` dans `video_url`, au même niveau que `url`
PDF	`file`	Chat : un seul parmi `file.file_url/file_data/file_id` ; contenu PDF uniquement actuellement
Audio	`input_audio`	Lite uniquement, Chat : un seul parmi `input_audio.url/data/file_id` ; `data` Base64 brut avec `format`
Image	`input_image`	Responses : chaîne `image_url` ou ID natif, pas l’objet imbriqué Chat
Vidéo	`input_video`	Responses : adresse vidéo dans la chaîne `video_url`, `fps` sur le même bloc
PDF	`input_file`	Responses : `file_url/file_data/file_id`, fichiers URL / Base64 limités à `50 MB`
Audio	`input_audio`	Lite uniquement, Responses : URL / Base64 Data URL dans `audio_url` ou ID natif, distinct de `input_audio.data` dans Chat
Image	`image`	Messages : URL publique via `source`, ou `media_type` et Base64 brut `data`
PDF	`document`	Messages : PDF via `source` dans un bloc document ; pas le bloc Chat `file`

Champ	Différence
`fps`	Plage `0.2～5`, défaut `1` ; emplacements Chat / Responses distincts, voir ci-dessus
Audio Lite	Fichier audio limité à `25 MB`, audio seul total par requête à `120 minutes` ; utiliser Chat / Responses
Médias Evolving	Images, images vidéo et documents acceptés ; ni audio ni bande-son vidéo
ID de fichier natif	Provient d’Ark Files API, associé au projet et au type ; aucune promesse d’API de téléversement AGTCloud équivalente

Exemples d’appel

Remplacez MODEL_ID par l’ID complet du modèle et utilisez votre API Key.

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Expliquez en trois points comment diagnostiquer un délai d’attente API"}],
    "reasoning_effort": "low",
    "max_completion_tokens": 4096
  }'