Passer au contenu principal
POST
/
v1
/
messages
Créer un message
curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}
'
{
  "model": "claude-haiku-4-5-20251001",
  "id": "msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "# Hey there! 👋\n\nHow's it going? What can I help you with today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 24
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt

Use this file to discover all available pages before exploring further.

BaseURL : La BaseURL par défaut est https://direct.evolink.ai, qui offre une meilleure prise en charge des modèles de texte et des connexions persistantes. https://api.evolink.ai est le point d’accès principal pour les services multimodaux et sert d’adresse de secours pour les modèles de texte.

Autorisations

​
Authorization
string
header
requis

##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
​
model
enum<string>
requis

Le modèle qui complétera votre invite.

Options disponibles:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-opus-4-5-20251101,
claude-opus-4-6,
claude-opus-4-7,
claude-sonnet-4-6
Exemple:

"claude-sonnet-4-5-20250929"

​
messages
InputMessage · object[]
requis

Messages d'entrée.

Nos modèles sont entraînés pour fonctionner sur des tours de conversation alternés user et assistant. Lors de la création d'un nouveau Message, vous spécifiez les tours de conversation précédents avec le paramètre messages, et le modèle génère ensuite le Message suivant dans la conversation. Les tours user ou assistant consécutifs dans votre requête seront combinés en un seul tour.

Chaque message d'entrée doit être un objet avec un role et un content. Vous pouvez spécifier un seul message de rôle user, ou vous pouvez inclure plusieurs messages user et assistant.

​
max_tokens
integer
requis

Le nombre maximum de tokens à générer avant de s'arrêter.

Notez que nos modèles peuvent s'arrêter avant d'atteindre ce maximum. Ce paramètre spécifie uniquement le nombre maximum absolu de tokens à générer.

Plage requise: x >= 1
Exemple:

1024

​
inference_geo
string

Specifies the geographic region for inference processing. If not specified, the workspace's default_inference_geo is used.

​
container

Paramètres du conteneur avec les compétences à charger.

​
context_management
ContextManagementConfig · object

Configuration de la gestion du contexte.

​
mcp_servers
RequestMCPServerURLDefinition · object[]

Serveurs MCP à utiliser dans cette requête

Maximum array length: 20
​
metadata
Métadonnées · object

Un objet décrivant les métadonnées de la requête.

​
output_config
OutputConfig · object

Configuration options for the model's output, such as the output format.

​
service_tier
enum<string>

Détermine s'il faut utiliser la capacité prioritaire (si disponible) ou la capacité standard pour cette requête.

Options disponibles:
auto,
standard_only
​
stop_sequences
string[]

Séquences de texte personnalisées qui feront arrêter la génération du modèle.

​
stream
boolean

S'il faut diffuser progressivement la réponse en utilisant des événements envoyés par le serveur.

​
system

Invite système.

Exemple:

"Today's date is 2024-06-01."

​
temperature
number

Quantité d'aléatoire injectée dans la réponse.

Par défaut 1.0. Plage de 0.0 à 1.0.

Plage requise: 0 <= x <= 1
Exemple:

1

​
thinking
Activé · object

Configuration pour activer la réflexion étendue de Claude.

type: "enabled" nécessite budget_tokens, avec un minimum de 1 024, et est comptabilisé dans max_tokens. Vous pouvez utiliser display pour contrôler l'affichage du contenu de réflexion.

type: "adaptive" laisse Claude décider dynamiquement quand et dans quelle mesure utiliser la réflexion étendue selon la complexité de la requête ; vous pouvez également utiliser display pour contrôler l'affichage du contenu de réflexion.

type: "disabled" désactive la réflexion étendue.

​
tool_choice
Auto · object

Comment le modèle doit utiliser les outils fournis.

​
tools
(Outil personnalisé · object | Outil Bash (2024-10-22) · object | Outil Bash (2025-01-24) · object | Outil d'exécution de code (2025-05-22) · object | CodeExecutionTool_20250825 · object | Outil d'utilisation d'ordinateur (2024-01-22) · object | MemoryTool_20250818 · object | Outil d'utilisation d'ordinateur (2025-01-24) · object | Outil d'édition de texte (2024-10-22) · object | Outil d'édition de texte (2025-01-24) · object | Outil d'édition de texte (2025-04-29) · object | TextEditor_20250728 · object | Outil de recherche Web (2025-03-05) · object | WebFetchTool_20250910 · object)[]

Définitions des outils que le modèle peut utiliser.

​
top_k
integer

Échantillonner uniquement parmi les K meilleures options pour chaque token suivant.

Plage requise: x >= 0
Exemple:

5

​
top_p
number

Utilisez l'échantillonnage nucleus.

Plage requise: 0 <= x <= 1
Exemple:

0.7

Réponse

Objet message

​
id
string
requis

Identifiant d'objet unique.

Le format et la longueur des ID peuvent changer au fil du temps.

Exemple:

"msg_013Zva2CMHLNnXjNJJKqJ2EF"

​
type
string
requis

Type d'objet.

Pour les Messages, c'est toujours "message".

Allowed value: "message"
​
role
string
requis

Rôle conversationnel du message généré.

Ce sera toujours "assistant".

Allowed value: "assistant"
​
content
(Text · object | Réflexion · object | Réflexion expurgée · object | Utilisation d'outil · object | Utilisation d'outils serveur · object | Résultat de l'outil de recherche Web · object | ResponseWebFetchToolResultBlock · object | Résultat de l'outil d'exécution de code · object | ResponseBashCodeExecutionToolResultBlock · object | ResponseTextEditorCodeExecutionToolResultBlock · object | Utilisation de l'outil MCP · object | Résultat de l'outil MCP · object | Téléchargement de conteneur · object)[]
requis

Contenu généré par le modèle.

Ceci est un tableau de blocs de contenu, chacun ayant un type qui détermine sa forme.

​
model
enum<string>
requis

Le modèle qui a traité la requête.

Options disponibles:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-opus-4-5-20251101,
claude-opus-4-6,
claude-opus-4-7,
claude-sonnet-4-6
Exemple:

"claude-sonnet-4-5-20250929"

​
stop_reason
enum<string> | null
requis

La raison pour laquelle nous nous sommes arrêtés.

Options disponibles:
end_turn,
max_tokens,
stop_sequence,
tool_use,
pause_turn,
refusal,
model_context_window_exceeded
​
stop_sequence
string | null
requis

Quelle séquence d'arrêt personnalisée a été générée, le cas échéant.

​
usage
Usage · object
requis

Utilisation de la facturation et des limites de débit.

​
context_management
ResponseContextManagement · object

Réponse de la gestion du contexte.

​
container
Conteneur · object

Informations sur le conteneur utilisé dans cette requête.