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

API Kimi (tous les modèles) - Responses : Référence complète

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

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

Authorization

string

header

requis

##Toutes les API nécessitent une authentification par 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

model

enum<string>

défaut:kimi-k3.1-pro

requis

Modèle à appeler :

Identifiant du modèle	Positionnement	Effort de raisonnement
`kimi-k3.1-pro`	Dernière génération (recommandée)	`low` / `high` / `max`, `max` par défaut
`kimi-k3.1-pro-highspeed`	Mêmes paramètres que Pro, génération plus rapide	Comme `kimi-k3.1-pro`
`kimi-k3`	Génération précédente	`max` uniquement

Les trois modèles ont une fenêtre de contexte de 1 048 576 tokens et un raisonnement toujours activé.

La sortie structurée (text.format) et le TTL d’écriture du cache (prompt_cache_options) sont réservés à la série K3.1 et ne sont pas pris en charge par kimi-k3.

Options disponibles:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

input

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

string

Instructions système au premier niveau, placées avant toutes les autres instructions.

stream

boolean

défaut:false

Si true, renvoie la réponse sous forme de flux SSE.

max_output_tokens

integer

défaut:131072

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 <= 1048576

reasoning

object

Configuration du raisonnement.

Show child attributes

text

object

Configuration du texte de sortie.

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

tool_choice

enum<string>

Contrôle les appels d’outils. Avec auto, le modèle décide d’appeler ou non un outil.

Options disponibles:

auto

include

enum<string>[]

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

prompt_cache_options

object

Options d’écriture du cache de contexte, prises en charge uniquement par kimi-k3.1-pro / kimi-k3.1-pro-highspeed ; kimi-k3 ne prend pas ce paramètre en charge. Sans ce champ, un cache de 5m est écrit automatiquement par défaut. Les écritures et lectures sont facturées séparément.

Show child attributes

temperature

number

défaut:1

Température d’échantillonnage, fixée par le modèle à 1 ; il n’est pas nécessaire de fournir ce champ. kimi-k3.1-pro / kimi-k3.1-pro-highspeed l’ignorent automatiquement ; kimi-k3 renvoie une erreur pour les valeurs non prises en charge.

top_p

number

défaut:0.95

Seuil d’échantillonnage nucleus, fixé par le modèle à 0.95 ; il n’est pas nécessaire de fournir ce champ. kimi-k3.1-pro / kimi-k3.1-pro-highspeed l’ignorent automatiquement ; kimi-k3 renvoie une erreur pour les valeurs non prises en charge.

Réponse

Réponse créée avec succès

Une réponse du modèle.

string

Identifiant unique de la réponse.

Exemple:

"resp_68f0c1c2d3e4f5a6b7c8d9e0"

object

enum<string>

Options disponibles:

response

created_at

integer

Horodatage Unix de création de la réponse.

completed_at

integer | null

Horodatage Unix de fin de réponse. Présent lorsque status vaut completed ou incomplete ; null pour in_progress ou failed.

status

enum<string>

État de la réponse. L’instantané initial du streaming est in_progress.

Options disponibles:

in_progress,

completed,

incomplete,

failed

model

string

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

usage

object | null

input_tokens inclut les lectures et écritures de cache. Pour obtenir l’entrée standard de la série K3.1, soustraire cached_tokens et cache_write_tokens ; pour kimi-k3, soustraire uniquement cached_tokens. output_tokens inclut déjà le raisonnement.

Show child attributes

incomplete_details

object | null

Motif fourni lorsque status vaut incomplete.

Show child attributes

error

object | null

Détails de l’erreur lorsque status vaut failed.

Show child attributes

instructions

string | null

reasoning

object | null

text

object | null

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

tool_choice

enum<string> | null

Contrôle les appels d’outils. Avec auto, le modèle décide d’appeler ou non un outil.

Options disponibles:

auto

max_output_tokens

integer | null

temperature

number | null

top_p

number | null

parallel_tool_calls

boolean

service_tier

string | null

store

boolean

Toujours false.

background

boolean | null

Toujours false.

previous_response_id

string | null

Toujours null.

conversation

object | null

Toujours null.

prompt_cache_options

object

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

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

API Kimi (tous les modèles) - Responses : Référence complète

Autorisations

Corps

Réponse