curl --request POST \
--url https://direct.evolink.ai/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kimi-k3.1-pro",
"input": "Reply with OK.",
"reasoning": {
"effort": "low"
},
"max_output_tokens": 1024
}
'{
"id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
"object": "response",
"created_at": 123,
"completed_at": 123,
"status": "in_progress",
"model": "<string>",
"output": [
{
"type": "reasoning",
"id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
"summary": [
{
"type": "summary_text",
"text": "<string>"
}
],
"encrypted_content": "<string>",
"status": "in_progress"
}
],
"usage": {
"input_tokens": 123,
"input_tokens_details": {
"cached_tokens": 123,
"cache_write_tokens": 123
},
"output_tokens": 123,
"output_tokens_details": {
"reasoning_tokens": 123
},
"total_tokens": 123
},
"incomplete_details": {
"reason": "max_output_tokens"
},
"error": {
"code": "<string>",
"message": "<string>"
},
"instructions": "<string>",
"reasoning": {},
"text": {},
"tools": [
{
"type": "function",
"name": "<string>",
"description": "<string>",
"parameters": {},
"strict": true
}
],
"tool_choice": "auto",
"max_output_tokens": 123,
"temperature": 123,
"top_p": 123,
"parallel_tool_calls": true,
"service_tier": "<string>",
"store": true,
"background": true,
"previous_response_id": "<string>",
"conversation": {},
"prompt_cache_options": {
"mode": "implicit",
"ttl": "5m"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}Responses API
Kimi K3.1 Pro / Highspeed - API Responses
Définissez l’effort via reasoning.effort et le cache via prompt_cache_options. La recherche apparaît dans des éléments web_search_call. En streaming, traitez response.completed / response.incomplete / response.failed ; la limite de sortie produit incomplete. Incluez tout l’historique output dans les requêtes multi-tours, raisonnement, appels d’outils et résultats compris.
POST
/
v1
/
responses
curl --request POST \
--url https://direct.evolink.ai/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kimi-k3.1-pro",
"input": "Reply with OK.",
"reasoning": {
"effort": "low"
},
"max_output_tokens": 1024
}
'{
"id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
"object": "response",
"created_at": 123,
"completed_at": 123,
"status": "in_progress",
"model": "<string>",
"output": [
{
"type": "reasoning",
"id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
"summary": [
{
"type": "summary_text",
"text": "<string>"
}
],
"encrypted_content": "<string>",
"status": "in_progress"
}
],
"usage": {
"input_tokens": 123,
"input_tokens_details": {
"cached_tokens": 123,
"cache_write_tokens": 123
},
"output_tokens": 123,
"output_tokens_details": {
"reasoning_tokens": 123
},
"total_tokens": 123
},
"incomplete_details": {
"reason": "max_output_tokens"
},
"error": {
"code": "<string>",
"message": "<string>"
},
"instructions": "<string>",
"reasoning": {},
"text": {},
"tools": [
{
"type": "function",
"name": "<string>",
"description": "<string>",
"parameters": {},
"strict": true
}
],
"tool_choice": "auto",
"max_output_tokens": 123,
"temperature": 123,
"top_p": 123,
"parallel_tool_calls": true,
"service_tier": "<string>",
"store": true,
"background": true,
"previous_response_id": "<string>",
"conversation": {},
"prompt_cache_options": {
"mode": "implicit",
"ttl": "5m"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}BaseURL : La BaseURL par défaut est
https://direct.evolink.ai, qui offre une meilleure prise en charge des modèles textuels et des connexions de longue durée. https://api.evolink.ai est le point de terminaison principal pour les services multimodaux et sert d’adresse de repli pour les modèles textuels.Autorisations
##Toutes les API nécessitent une authentification Bearer Token##
Obtenir une clé API :
Visitez la Page de gestion des clés API pour obtenir votre clé API
Ajouter à l'en-tête de requête :
Authorization: Bearer YOUR_API_KEY
Corps
application/json
Utilisez kimi-k3.1-pro ou kimi-k3.1-pro-highspeed ; Highspeed génère plus vite.
Options disponibles:
kimi-k3.1-pro, kimi-k3.1-pro-highspeed input
string(Message · object | Raisonnement · object | Function Call · object | Résultat d’appel de fonction · object | Appel d’outil personnalisé · object | Résultat d’appel d’outil personnalisé · object | Appel de recherche web · object | Outils dynamiques · object)[]
requis
Entrée de la requête. Une chaîne équivaut à un message user. Un tableau contient des éléments typés dans l’ordre, dont l’historique, les appels d’outils et leurs résultats.
Instructions système au premier niveau, placées avant toutes les autres instructions.
Si true, renvoie la réponse sous forme de flux SSE.
Nombre maximal de tokens générés, raisonnement et réponse finale inclus. Par défaut : 131072 ; maximum : 1048576, dans la limite du contexte restant.
Plage requise:
1 <= x <= 1048576Configuration du raisonnement.
Show child attributes
Show child attributes
Configuration du texte de sortie.
Show child attributes
Show child attributes
tools
(Outil de fonction · object | Outil personnalisé · object | Outil d’espace de noms · object | Outil de recherche web · object)[]
Outils que le modèle peut appeler.
Définition d’outil identifiée par type. Accepte function, custom (uniquement apply_patch), namespace et web_search ; les autres types ne sont pas pris en charge.
- Outil de fonction
- Outil personnalisé
- Outil d’espace de noms
- Outil de recherche web
Show child attributes
Show child attributes
Contrôle les appels d’outils. Avec auto, le modèle décide d’appeler ou non un outil.
Options disponibles:
auto Champs supplémentaires, uniquement pour web_search. web_search_call.action.sources renvoie les sources web trouvées ; web_search_call.results, les résultats d’images.
Options disponibles:
web_search_call.results, web_search_call.action.sources Options d’écriture du cache de contexte. Sans ce champ, écriture automatique dans le cache 5m. Lectures et écritures sont facturées séparément.
Show child attributes
Show child attributes
Réponse
Réponse créée avec succès
Une réponse du modèle.
Identifiant unique de la réponse.
Exemple:
"resp_68f0c1c2d3e4f5a6b7c8d9e0"
Options disponibles:
response Horodatage Unix de création de la réponse.
Horodatage Unix de fin de réponse. Présent lorsque status vaut completed ou incomplete ; null pour in_progress ou failed.
État de la réponse. L’instantané initial du streaming est in_progress.
Options disponibles:
in_progress, completed, incomplete, failed Modèle ayant généré cette réponse.
output
(Raisonnement · object | Message · object | Function Call · object | Appel d’outil personnalisé · object | Appel de recherche web · object)[]
Tableau des éléments de sortie dans l’ordre : web_search_call (si présent), reasoning, message, appels d’outils.
Élément du tableau output, identifié par type.
- Raisonnement
- Message
- Function Call
- Appel d’outil personnalisé
- Appel de recherche web
Show child attributes
Show child attributes
input_tokens inclut les lectures et écritures du cache ; soustrayez cached_tokens et cache_write_tokens pour obtenir l’entrée ordinaire. output_tokens inclut déjà le raisonnement.
Show child attributes
Show child attributes
Motif fourni lorsque status vaut incomplete.
Show child attributes
Show child attributes
Détails de l’erreur lorsque status vaut failed.
Show child attributes
Show child attributes
tools
(Outil de fonction · object | Outil personnalisé · object | Outil d’espace de noms · object | Outil de recherche web · object)[] | null
Définition d’outil identifiée par type. Accepte function, custom (uniquement apply_patch), namespace et web_search ; les autres types ne sont pas pris en charge.
- Outil de fonction
- Outil personnalisé
- Outil d’espace de noms
- Outil de recherche web
Show child attributes
Show child attributes
Contrôle les appels d’outils. Avec auto, le modèle décide d’appeler ou non un outil.
Options disponibles:
auto Toujours false.
Toujours false.
Toujours null.
Toujours null.
Options d’écriture du cache de contexte réellement appliquées par le serveur. Si prompt_cache_options est absent, utilisez les valeurs mode et ttl renvoyées ici.
Show child attributes
Show child attributes