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

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

Pour Kimi, 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
kimi-k3.1-pro, kimi-k3.1-pro-highspeed, kimi-k3	Règles communes aux trois protocoles ; modèles concernés par chaque extension indiqués dans la ligne correspondante

Différences Chat Completions

Champ	Différence
`temperature`, `top_p`	Fixés respectivement à `1.0`, `0.95` ; omission recommandée. Toute autre valeur provoque une erreur
`n`, `presence_penalty`, `frequency_penalty`	Fixés respectivement à `1`, `0`, `0` ; toute autre valeur provoque une erreur
`reasoning_effort`	Accepte `low/high/max`, défaut `max`. Raisonnement et conservation toujours actifs ; ne pas utiliser le commutateur K2.x `thinking`
`max_completion_tokens`	Défaut `131072`, maximum `1048576`. Si entrée et budget de sortie dépassent le contexte, le budget diminue automatiquement ; l’entrée seule doit toujours tenir
`stop`	Au plus 5 chaînes, chacune limitée à 32 octets
`tool_choice`	Accepte `auto/none/required` ; la forme objet imposant une fonction est incompatible avec le raisonnement et renvoie `400`
`messages[].reasoning_content`	Renvoyer les messages assistant complets sans modification, raisonnement et `tool_calls` compris, pour les échanges et appels d’outils
`messages[].partial`	Extension Kimi Partial Mode : mettre `true` sur le dernier message assistant pour continuer son préfixe ; incompatible avec `response_format.type=json_object`
`messages[].tools`	Outils dynamiques documentés pour kimi-k3.1-pro et kimi-k3 : ajouter un message system avec toutes les définitions, sans `content`. Les outils deviennent visibles dès ce point ; conserver ce message ensuite

Différences Responses

Champ	Différence
`reasoning.effort`	Accepte `low/high/max` ; défaut : `max`
`max_output_tokens`	Défaut : `131072` ; maximum : `1048576`
`tool_choice`	Accepte uniquement `auto`
`tools[].type`	Accepte uniquement `function/namespace/custom/web_search` ; le nom de l’outil `custom` doit être `apply_patch`
`text.format`	Utiliser `type: "json_schema"` et `schema` ; `name` vaut `output` si omis
Champs d’état de conversation renvoyés	`store` et `background` fixés à `false`, `previous_response_id` et `conversation` à `null`. Renvoyer les entrées et sorties côté client, sans dépendre d’une chaîne sauvegardée côté serveur

Différences Messages

Champ	Différence
`max_tokens`	Obligatoire ; minimum `1` ; `0` interdit
`output_config.effort`	Accepte `low/high/max` ; défaut : `max`
`tool_choice.type`	Accepte `auto/any/none` ; défaut : `auto`
`stop_sequences`	Au plus 5 chaînes, chacune limitée à 32 octets
Blocs `thinking` précédents	Les renvoyer inchangés avec `signature` dans le prochain message assistant
`output_config.format`	La sortie structurée exige `type: "json_schema"` et `schema`

Différences de cache

Champ	Différence
`prompt_cache_options` de Chat / Responses	`mode` accepte seulement `implicit` ; `ttl` accepte `5m/1h`, défaut `5m`. Sans configuration, écriture d’un cache de 5 minutes par défaut
`prompt_cache_breakpoint` de Chat / Responses	Points de rupture explicites non pris en charge ; leur présence dans le contenu renvoie `400`
`cache_control` de Messages	Seule la configuration à la racine agit ; marqueurs dans `messages` ignorés. `type` fixé à `ephemeral` ; `ttl` accepte `5m/1h`, défaut `5m`. Sans configuration, lecture et écriture avec TTL de 5 minutes
Intensité du raisonnement	Changer le niveau rompt les correspondances du préfixe ; le choisir en début de conversation

Différences d’entrée multimédia

Entrée	Bloc du protocole	Différence
Image	`image_url`	Chat : `image_url.url` reçoit Base64 Data URL ou référence native `ms://<file_id>` ; URL publique d’image ordinaire non acceptée
Vidéo	`video_url`	Chat : Base64 Data URL ou référence `ms://<file_id>` d’une vidéo téléversée
Image	`input_image`	Responses : `image_url` reçoit Base64 Data URL, pas d’URL publique HTTP(S)
Image	`image`	Messages : pour `source.type=base64`, fournir `media_type` et `data` ; pour `source.type=url`, mettre la référence native `ms://<file_id>` dans `source.url`
SVG	Entrée image	SVG non accepté, même en Base64 ; envoyer le XML comme texte pour l’analyser

ms:// est le format de référence natif Kimi et exige un téléversement préalable chez Kimi. Cette page ne fournit pas d’API de téléversement AGTCloud.

Exemples d’appel

Remplacez MODEL_ID par l’ID complet disponible pour le protocole choisi 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,
    "prompt_cache_options": {"mode": "implicit", "ttl": "1h"}
  }'