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

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

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

Modèles concernés

Modèle	Portée
qwen3.8-max-0902, qwen3.8-flash, qwen3.8-max	Tous acceptent Chat, Responses, Messages ; règles communes regroupées, portée multimédia précisée ci-dessous

Différences Chat Completions

Champ	Différence
`enable_thinking`, `reasoning_effort`	Raisonnement actif par défaut ; niveaux effectifs `low/medium/xhigh`, défaut `xhigh`. `minimal` devient `low`, `high/max` devient `xhigh`, `none` désactive
`thinking_budget`	Incompatible avec `reasoning_effort`, sinon erreur. Avec le niveau seul, `low/medium/xhigh` correspondent aux budgets `4096/16384/262144`
`max_tokens`, `max_completion_tokens`	`max_tokens` limite la réponse finale seulement et sera déprécié ; utiliser `max_completion_tokens` pour le budget total raisonnement et réponse
`temperature`	Plage `[0,2)` ; défauts en raisonnement : texte `1.0`, visuel `0.6`. Sous `0.6`, devient `0.6` ; sans raisonnement : `0.7`
`top_p`, `top_k`	`top_p` : plage `(0,1]`, défauts raisonnement / sans raisonnement `0.95/0.8`. Extension `top_k` : entier positif ou nul, défaut `20` ; `null` ou au-dessus de `100` désactive Top-K
`repetition_penalty`	Extension Qwen ; supérieur à `0`, défaut `1.0`, distinct des deux pénalités OpenAI
`preserve_thinking`	Actif par défaut ; renvoyer toute pensée dans `reasoning_content` de assistant, pas dans `content`. L’absence de pensée ne provoque pas à elle seule une erreur
`tool_choice`	Accepte `auto/none`. En raisonnement, ni `required` ni fonction imposée ; sans raisonnement, fonction nommée possible, mais `required` ne garantit toujours pas d’appel
`tool_stream`	Défaut `false` ; arguments complexes incrémentaux avec `stream=true` seulement. Max : texte ; Flash : toutes modalités
`response_format`	Accepte `json_object/json_schema` ; le premier exige le mot JSON dans le prompt ; le second définit la structure via `response_format.json_schema`. Raisonnement compatible
`enable_search`, `search_options`	`enable_search` : défaut `false` ; `search_options.forced_search` force la recherche. Stratégies `turbo/max` pour ces modèles ; avec `include_tool_usage=true`, statistiques réelles dans `usage.x_tools`

Différences Responses

Champ	Différence
`reasoning.effort`	Accepte `none/low/medium/xhigh`, défaut `xhigh` ; `minimal` devient `low`, `high/max` devient `xhigh`
`enable_thinking`	Commutateur de compatibilité destiné à disparaître ; préférer `reasoning.effort`. Si les deux sont fournis, `reasoning.effort` prévaut
`max_output_tokens`	Minimum `16`, raisonnement et réponse inclus
`text.format`	Accepte `text/json_object/json_schema` ; JSON Schema dans `text.format.json_schema` avec `name/schema/strict`, contrairement à la structure plate d’origine
`tool_choice`	Accepte `auto/none/required` et objet `allowed_tools` ; `required` uniquement si la liste contient un seul outil
`tools`	Fonctions et outils intégrés `web_search`, `web_extractor`, `code_interpreter`, etc. Extraction Web avec recherche ; interpréteur de code avec raisonnement
`store`, `previous_response_id`, `conversation`	Historique serveur disponible ; `store` : défaut `true`, ID de réponse valable `7 jours`. Les deux derniers champs sont incompatibles
`background` et autres extensions	Pas d’exécution asynchrone en arrière-plan ; paramètres OpenAI absents de la Reference Responses officielle ignorés

Différences Messages

Champ	Différence
`thinking.type`	Accepte `enabled/disabled`, raisonnement actif par défaut ; ne pas reprendre la configuration Claude `adaptive`
`output_config.effort`	Utilise `low/medium/xhigh`, défaut `xhigh` ; `high/max` devient `xhigh`, sans reprendre toutes les correspondances Chat
`thinking.budget_tokens`	Dépréciation annoncée ; nouvelles intégrations : `output_config.effort`. Avec l’ancien budget, `max_tokens` doit le dépasser
`max_tokens`	Obligatoire ; Qwen3.8 limite le total raisonnement et réponse
`temperature`, `messages[].role`	Température : `[0,2)` ; rôles autorisés : `user/assistant` et aussi `system`
`tool_result.content`	Renvoyer les résultats en chaîne ; sérialiser objets et tableaux au lieu des tableaux de blocs Claude
`output_config.format`	JSON Schema strict accepté ; `type: "json_schema"`, Schema dans `schema`, et `additionalProperties` égal à `false`
`web_search` dans `tools`	Outil nommé `web_search`, type daté comme `web_search_20250305` ; HTTP / SDK exige aussi l’identifiant client `x-anthropic-billing-header: cc_entrypoint=cli;` dans `system`

Différences de cache

Champ	Différence
Cache implicite	Automatique ; préfixe identique d’au moins `1024 Token`, sans garantie de hit
Cache explicite Chat / Messages	Marquer les blocs avec `cache_control: { type: "ephemeral" }` ; minimum `1024 Token`, validité `5 minutes` renouvelée au hit ; au plus `4` marqueurs
Emplacement du cache explicite	System doit être un tableau de blocs. Les définitions d’outils participent au préfixe, mais leurs marqueurs seuls sont ignorés. Ne pas reprendre d’autres TTL ou points de rupture de la Reference générale
Cache Session Responses	Activer via Header `x-dashscope-session-cache: enable`, défaut `disable`. Le désactiver n’arrête pas le cache implicite automatique
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`

Différences d’entrée multimédia

Entrée	Bloc du protocole	Différence
Image	`image_url`	Chat : `image_url.url` accepte URL publique ou Base64 Data URL
Vidéo	`video_url`	Extension Chat : `video_url.url` accepte URL publique ou Base64 Data URL ; `fps` sur le bloc au niveau de `video_url`
Liste de trames	`video`	Extension Chat : images chronologiques dans le tableau `video`, minimum `4` trames
Image	`input_image`	Responses : `image_url` chaîne URL publique ou Base64 Data URL complet, pas l’objet imbriqué Chat
PDF	`input_file`	Responses liste explicitement qwen3.8-max et qwen3.8-flash ; PDF public dans `file_url`, maximum `100 MB`. Ne pas ajouter les paramètres propres à OCR
Image	`image`	Messages : `url` pour `source.type=url` ; `media_type` et Base64 brut `data` pour `base64`
Vidéo	`video`	Extension Messages : URL publique via `source`, ou `media_type` et Base64 brut `data` ; ce n’est pas un bloc Claude natif

Champ	Différence
Contrôles d’image Chat	`min_pixels/max_pixels` sur le bloc ajuste les pixels ; si `vl_high_resolution_images=true` à la racine, `max_pixels` est sans effet
Taille des images	Images publiques : maximum `20 MB`. Avant encodage Base64 : `20 MB` ; Data URL après encodage : `20 MB` dans Chat, `32 MB` dans Messages
Limites vidéo	Vidéo publique : maximum `2 GB` ; chaîne Base64 inférieure à `10 MB`. Analyse visuelle seulement, sans audio
Portée des protocoles	Pas d’API audio Omni pour ces trois modèles ; `input_audio/input_video` de Responses réservé à Omni. Ne pas déplacer les blocs vidéo Chat / Messages vers Responses

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
  }'