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

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

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

Modèles concernés

Modèle	Portée
deepseek-flash	Chat, Responses, Messages ; images acceptées
deepseek-v4-pro	Chat, Responses, Messages ; pas d’images, recherche serveur avec Responses

Différences Chat Completions

Champ	Différence
`thinking.type`	Raisonnement actif par défaut sur les deux modèles ; accepte `enabled/disabled`
`reasoning_effort`	`none` désactive, `low/high/max` active, défaut `high`. Correspondances : `minimal` vers `low`, `medium/xhigh` vers `high`, `ultra` vers `max`
`temperature`	Plage `0～2` ; valeur ignorée en mode raisonnement
`top_p`	Flash : plage effective `0.95～1` en raisonnement ; sous `0.95`, devient `0.95`. Sans raisonnement, fixé à `1`. Pro : ignore la valeur en raisonnement, fixe à `0.95` avec `tools`, sinon `1` ; actif sans raisonnement
`max_tokens`	DeepSeek utilise toujours ce champ, non déprécié ; plage `1～393216`. Défauts : `8192` sans raisonnement, `65536` avec, `131072` au niveau `max`
`presence_penalty`, `frequency_penalty`	Officiellement déprécié ; sans effet
`stop`	Chaîne ou tableau de chaînes ; au plus `16` chaînes d’arrêt
`response_format.type`	Accepte `text/json_object` ; demander aussi explicitement du JSON dans le prompt
`tools`, `tool_choice`	Function Tools seulement ; en raisonnement, `required` ou une fonction imposée renvoie `400`. Désactiver le raisonnement d’abord
Historique `reasoning_content`	Avec raisonnement et `tools`, renvoyer toutes les pensées assistant, même sans appel d’outil. Sans `tools`, raisonnement historique ignoré
`stream_options.include_usage`	Uniquement avec `stream: true`. Le dernier bloc contient l’usage complet dans tous les cas, sans bloc distinct `choices: []`. Si activé, `usage` des blocs précédents vaut `null`
`user_id`	Extension DeepSeek : `512` caractères maximum, lettres, chiffres, tirets et soulignements seulement. Sépare utilisateurs, caches et ordonnancement ; pas de données personnelles

Différences Responses

Champ	Différence
`input`, `instructions`	Fournir au moins un champ ; `instructions` devient le premier message system, rôle `developer` traité comme `user`
`reasoning.effort`	Défaut `high`, accepte `none/low/high/max`, correspondances comme ci-dessus ; `none` désactive le raisonnement
`temperature`, `top_p`	Valeurs et comportement identiques au tableau précédent ; distinguer Flash et Pro
`previous_response_id`, `conversation`, `store`	API sans état ; valeurs ignorées. Renvoyer l’historique des entrées et sorties ; réponses fixées à `previous_response_id: null`, `store: false`
`text.format`	Accepte `text/json_object/json_schema` ; JSON Schema exige `name` et `schema`
`text.verbosity`, `reasoning.summary`	Le premier est sans effet, le second ne produit pas de résumé. reasoning historique : `content` en clair uniquement, pas `summary/encrypted_content`
`tools`	Function Tools acceptés ; Custom Tool nommé `apply_patch` seulement, sinon `400`. `web_search` actif sur Pro, ignoré sur Flash ; `file_search`, `code_interpreter`, `computer_use`, `mcp` ignorés
`tool_choice`	Accepte `none/auto/required` et une Function Tool nommée
`parallel_tool_calls`, `max_tool_calls`	Valeurs ignorées ; appels parallèles toujours actifs, réponse `parallel_tool_calls` fixée à `true`
`truncation`	Ignoré, sans troncature automatique ; contexte dépassé : `400`
`background`, `metadata`, `include`, `prompt`	Valeurs ignorées
`service_tier`, `safety_identifier`, `context_management`, `stream_options`	Valeurs ignorées

Différences Messages

Champ	Différence
`anthropic-version`	DeepSeek ignore ce Header ; la date de version Anthropic ne modifie pas les règles
`thinking`, `output_config.effort`	Raisonnement actif par défaut ; `thinking.type` accepte `enabled/disabled`, `budget_tokens` ignoré. Niveaux `low/high/max`, défaut `high`, correspondances Chat ; `output_config` accepte seulement `effort`
`temperature`, `top_p`	Valeurs et comportement identiques à Chat ; `top_k` ignoré
`tool_choice.type`	Accepte `none/auto/any/tool` ; `disable_parallel_tool_use` ignoré
`metadata`	Accepte seulement `user_id` ; autres champs ignorés
`container`, `mcp_servers`, `service_tier`	Valeurs ignorées
Texte et résultats d’outils	`citations` du texte et `is_error` du résultat ignorés ; marqueurs dans le tableau de cache
Blocs de contenu	Non pris en charge : `document`, `search_result`, `redacted_thinking`, `code_execution_tool_result`, `mcp_tool_use`, `mcp_tool_result`, `container_upload`

Différences de cache

Champ	Différence
Cache automatique de préfixe	Actif par défaut, sans configuration ; préfixes complets identiques aux unités sauvegardées susceptibles de correspondre, pas n’importe quel fragment
`prompt_cache_key` et `prompt_cache_retention` de Responses	Valeurs ignorées ; cache géré automatiquement
`cache_control` de Messages	Marqueurs dans les blocs et définitions d’outils ignorés
Utilisation du cache	Chat : `usage.prompt_cache_hit_tokens`, `usage.prompt_cache_miss_tokens` ; Responses : `usage.input_tokens_details.cached_tokens`

Différences d’entrée multimédia

Seul deepseek-flash accepte les images ; deepseek-v4-pro ne les accepte pas.

Entrée	Bloc du protocole	Différence
Image	`image_url`	Chat : `image_url.url` reçoit URL publique ou Base64 Data URL
Image	`input_image`	Responses : `image_url` reçoit URL publique / Base64 Data URL dans user / developer ou les sorties d’outils ; image dans system / assistant : `400`
Image	`image`	Messages : fournir `url` pour `source.type=url`, ou `media_type` et `data` pour `source.type=base64`

Champ	Différence
`detail`	Chat : dans `image_url` ; Responses : dans le bloc. Accepte `low/high/original/auto`, `low` réduit à `512×512` ; les trois autres valeurs sont équivalentes
Formats et tailles d’image	JPEG, PNG, GIF, WebP ; maximum `32 MiB` par image URL / Base64, corps `48 MiB`, encodage Base64 compris
URL d’image	Au plus `8192` caractères ; téléchargement achevé en `60` secondes

Exemples d’appel

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

curl 'https://api.agtcloud.cn/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"}],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high",
    "max_tokens": 4096
  }'