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

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "max_tokens": 1024,
  "output_config": {
    "effort": "low"
  },
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ]
}
'

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

POST

messages

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "max_tokens": 1024,
  "output_config": {
    "effort": "low"
  },
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ]
}
'

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<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 (output_config.format), les séquences d’arrêt (stop_sequences) et le TTL d’écriture du cache (cache_control) sont réservés à la série K3.1 et ne sont pas pris en charge par kimi-k3. Les réponses de kimi-k3 peuvent contenir uniquement des blocs text, sans blocs thinking.

Options disponibles:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

max_tokens

integer

requis

Nombre maximal de tokens autorisés pour cette génération, y compris thinking et le texte final.

Plage requise: 1 <= x <= 1048576

messages

object[]

requis

Liste de messages Anthropic Messages. Pour une conversation multi-tour, renvoyez les blocs de contenu assistant complets sans modification.

Minimum array length: 1

Show child attributes

system

Prompt système sous forme de chaîne ou de tableau de blocs text.

stream

boolean

défaut:false

Indique si un flux d'événements Anthropic SSE est renvoyé.

tools

object[]

Fonctions personnalisées ou recherche web côté serveur. La recherche intégrée utilise type=web_search_20250305 et name=web_search ; facturation par appel effectué.

Option 1
Option 2

Show child attributes

tool_choice

object

Show child attributes

stop_sequences

string[]

Séquences d’arrêt. Une correspondance exacte arrête la sortie ; la séquence correspondante n’est pas émise. Jusqu’à 5 séquences, de 32 octets maximum chacune. En cas de correspondance, stop_reason vaut end_turn et stop_sequence vaut null.

Prises en charge uniquement par kimi-k3.1-pro / kimi-k3.1-pro-highspeed, pas par kimi-k3.

Maximum array length: 5

cache_control

object

Options d’écriture de cache au niveau supérieur, prises en charge uniquement par kimi-k3.1-pro / kimi-k3.1-pro-highspeed, pas par kimi-k3. Seul cache_control au niveau supérieur contrôle le TTL d’écriture ; les marqueurs de cache dans les blocs de messages ne remplacent pas ce champ. Valeur par défaut si omis : 5m.

Show child attributes

output_config

object

Configuration de sortie : effort de raisonnement et sortie structurée.

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 Message ; les requêtes en streaming renvoient un flux d'événements Anthropic SSE

string

type

enum<string>

Options disponibles:

message

role

enum<string>

Options disponibles:

assistant

model

string

Exemple:

"kimi-k3.1-pro"

content

object[]

Bloc de contenu Anthropic pour le texte, l'image, le raisonnement, l'appel d'outil ou le résultat d'outil.

Show child attributes

stop_reason

enum<string> | null

Options disponibles:

end_turn,

max_tokens,

tool_use,

refusal,

null

stop_sequence

string | null

usage

object

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) - Messages : Référence complète

Autorisations

Corps

Réponse