Passer au contenu principal
POST
/
v1
/
messages
Créer un message
curl --request POST \
  --url https://api.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
  }
}

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

​
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.

​
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.

​
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-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.