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

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

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

Modèles concernés

Modèle	Portée
hy4-preview	Chat, Responses, Messages ; niveaux Chat `none/high`, défaut `high`
hy3	Chat, Responses, Messages ; niveaux Chat `none/low/high`, défaut `high`. Conservation et limites d’outils selon le tableau

Différences Chat Completions

Champ	Différence
`thinking.type`	Les deux raisonnent par défaut ; commutateur explicite `enabled/disabled`. Niveaux de `reasoning_effort` ci-dessus
`reasoning_effort`	Hy3 avec `tools` transforme `low` en `high` ; le modèle règle ensuite sa profondeur selon la tâche d’outil
`max_tokens`, `max_completion_tokens`	Les deux limitent raisonnement et réponse ; le dernier prévaut. Hy3 : au moins `16000` recommandé, pas un minimum obligatoire
`top_k`, `repetition_penalty`	Ignorés silencieusement ; pas d’extensions semblables à Qwen
`n`	Doit être `1` avec raisonnement actif
`preserved_thinking`	Conservation Hy3 : active par défaut avec `tools`, inactive en conversation texte simple ; orthographe `preserved_thinking`
Historique `reasoning_content`	Au retour des outils, conserver toute pensée assistant précédente et `tool_calls`. L’activation ne complète pas l’historique client manquant
`tool_choice`	En raisonnement, utiliser `auto/none`, pas `required` ni une fonction imposée
`web_search_options`	Recherche native Hy3 : `enable: true`, `search_source` utilisant `standard/lite`, défaut `standard`. Cette ligne concerne Hy3 seulement

Différences Responses

Champ	Différence
`max_output_tokens`	Inclut raisonnement et réponse ; ne pas budgéter le texte visible seulement
`tool_choice`	Hy3 : uniquement `auto/none`, ni `required` ni objet imposant une fonction
`previous_response_id`	Hy3 renvoie `400` pour une valeur non vide ; inclure soi-même l’historique dans `input`
`reasoning.preserved_thinking`	Conservation Hy3 dans l’objet `reasoning` ; mêmes valeurs par défaut que Chat
`text.format`	Accepte `text/json_object/json_schema` ; JSON Schema Hy3 exige `additionalProperties: false`
`web_search` dans `tools`	Recherche native Hy3 : `type: "web_search"`, emplacement différent de `web_search_options` dans Chat

Différences Messages

Champ	Différence
`thinking.type`, `max_tokens`	Commutateur explicite `enabled/disabled` ; `max_tokens` inclut raisonnement et réponse. Réserver de la place au texte avec `budget_tokens`
`HY-Preserved-Thinking`	Header de conservation Hy3 : `true/false`, comportement par défaut si omis. Ne pas déplacer le champ racine Chat dans Messages
Blocs thinking précédents	Conserver les contenus assistant réels avec les résultats. Si Hy3 ne renvoie pas `signature`, ne pas inventer de signature ; règle Claude non applicable

Différences de cache

Champ	Différence
`prompt_cache_key`	Identifiant de cache Chat ; préfixe et valeur stables, hits confirmés dans la réponse
Conservation du raisonnement et cache	Conserver la pensée prolonge le raisonnement sans prouver un hit ; historique complet et stable favorable au préfixe
Utilisation du cache	Chat : `usage.prompt_tokens_details.cached_tokens` ; Responses : `usage.input_tokens_details.cached_tokens` effectivement renvoyé ; Messages : `usage.cache_read_input_tokens` effectivement renvoyé

Exemples d’appel

Remplacez MODEL_ID par l’ID complet et utilisez votre API Key. Toutes les entrées ci-dessous sont textuelles.

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"}],
    "reasoning_effort": "high",
    "max_completion_tokens": 16384
  }'