Créer un message Claude
Point de terminaison compatible avec l'API Messages de Claude. Définissez stream=true pour recevoir des événements de flux de messages au format Claude. Les champs de requête, de réponse et d'erreur de validation suivent le protocole Claude Messages ; le Router peut également renvoyer une enveloppe d'erreur de passerelle assainie en cas de défaillance d'infrastructure.
- Type: stringX
- Felo - Channel Codes de canaux publics ordonnés, séparés par des virgules. Omettre cet en-tête pour utiliser default ; default doit être utilisé seul. En mode portefeuille, default parcourt l'ordre effectif des canaux publics du modèle dans l'ordre inverse, ignore les canaux non publiés ou indisponibles et sélectionne le fournisseur du premier canal disponible. Il inclut les points de terminaison disponibles de ce fournisseur ayant le même ID de modèle amont et le même niveau de service. Les canaux explicites sont validés dans l'ordre spécifié par le client ; seul le groupe de fournisseurs du premier canal est soumis. Aucun repli automatique vers d'autres fournisseurs. Les anciens en-têtes de fournisseur ne peuvent pas remplacer le routage par canaux.
- Type: integermax
_tokens min.:1obligatoireInteger numbers.
- Type: array object[] · ClaudeMessage[] 1…messagesobligatoire
- contentobligatoire
- Type: string
- roleType: string enumobligatoirevaleurs
- user
- assistant
- propertyType: anything
Name
- Type: stringmodelobligatoire
- Type: objectmetadata
- propertyType: anything
Name
- Type: string | nullservice
_tier Seule la valeur default (standard) est actuellement prise en charge. Une valeur omise, null, un alias ou une chaîne non prise en charge revient à default ; les autres types renvoient HTTP 400. Les canaux et tarifs configurés restent inchangés. Les API de texte envoient la valeur standard du fournisseur ; les API Decisions et de génération omettent le champ amont.
- Type: array string[]stop
_sequences - Type: booleanstream
- system
- Type: string
- Type: numbertemperaturemin.:0max.:1
- Type: objectthinking
- propertyType: anything
Name
- tool
_choice - Type: string
- Type: array object[]tools
- propertyType: anything
Name
- Type: anythingproperty
Name
- Type: integertop
_k min.:0Integer numbers.
- Type: numbertop
_p min.:0max.:1 - Type: anythingproperty
Name
- Type: object · ClaudeMessageResponse200
Message Claude ou réponse en streaming
- Type: array object[] · ClaudeContentBlock[]contentobligatoire
- typeType: string enumobligatoirevaleurs
- text
- image
- document
- tool
_use - tool
_result - thinking
- contentType: string | array
- idType: string
- inputType: object
- propertyType: anything
Name
- nameType: string
- sourceType: object
- propertyType: anything
Name
- textType: string
- propertyType: anything
Name
- Type: stringidobligatoire
- Type: stringmodelobligatoire
- roleconstante:assistantobligatoire
- Type: string | nullstop
_reason obligatoire - typeconstante:messageobligatoire
- Type: string | nullstop
_sequence - Type: object · Usageusage
Objet d'utilisation du fournisseur. Les champs varient selon le point de terminaison et le fournisseur.
- propertyType: anything
Name
- Type: anythingproperty
Name
- Type: object · ClaudeErrorResponse400
Erreur invalid_request_error de Claude ou erreur de validation de requête du Router
Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.
- Type: objecterrorobligatoire
- messageType: stringobligatoire
- typeType: stringobligatoire
- propertyType: anything
Name
- typeconstante:errorobligatoire
- Type: stringrequest
_id - Type: anythingproperty
Name
application/json - Type: object · ClaudeErrorResponse401
Clé API Felo invalide ou manquante
Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.
- Type: objecterrorobligatoire
- messageType: stringobligatoire
- typeType: stringobligatoire
- propertyType: anything
Name
- typeconstante:errorobligatoire
- Type: stringrequest
_id - Type: anythingproperty
Name
application/json - Type: object · ClaudeErrorResponse402
Solde insuffisant
Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.
- Type: objecterrorobligatoire
- messageType: stringobligatoire
- typeType: stringobligatoire
- propertyType: anything
Name
- typeconstante:errorobligatoire
- Type: stringrequest
_id - Type: anythingproperty
Name
application/json - Type: object · ClaudeErrorResponse403
Le compte n'est pas autorisé à utiliser le modèle. Les modèles désactivés sont également rejetés avant tout appel amont. Les requêtes acceptées et les tâches en cours se poursuivent.
Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.
- Type: objecterrorobligatoire
- messageType: stringobligatoire
- typeType: stringobligatoire
- propertyType: anything
Name
- typeconstante:errorobligatoire
- Type: stringrequest
_id - Type: anythingproperty
Name
application/json - Type: object · ClaudeErrorResponse429
Limite de dépenses ou de requêtes atteinte
Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.
- Type: objecterrorobligatoire
- messageType: stringobligatoire
- typeType: stringobligatoire
- propertyType: anything
Name
- typeconstante:errorobligatoire
- Type: stringrequest
_id - Type: anythingproperty
Name
application/json - Type: object · ClaudeErrorResponse502
Échec de la requête auprès du fournisseur amont
Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.
- Type: objecterrorobligatoire
- messageType: stringobligatoire
- typeType: stringobligatoire
- propertyType: anything
Name
- typeconstante:errorobligatoire
- Type: stringrequest
_id - Type: anythingproperty
Name
application/json - Type: object · ClaudeErrorResponse503
Fournisseur ou service de facturation indisponible
Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.
- Type: objecterrorobligatoire
- messageType: stringobligatoire
- typeType: stringobligatoire
- propertyType: anything
Name
- typeconstante:errorobligatoire
- Type: stringrequest
_id - Type: anythingproperty
Name
application/json
curl https://openapi.felo.ai/api/v1/messages \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Write a one-sentence greeting."
}
],
"stream": false
}'
{
"id": "string",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "string",
"id": "string",
"name": "string",
"input": {
"additionalProperty": "anything"
},
"content": "string",
"source": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}
],
"model": "string",
"stop_reason": null,
"stop_sequence": null,
"usage": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}