Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Créer un message Claude

Serveur:https://openapi.felo.ai
Bibliothèques clientes

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.

En-têtes
  • X-Felo-Channel
    Type: string

    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.

Corps·ClaudeMessagesRequest
obligatoire
application/json
  • max_tokens
    Type: integer
    min.:  
    1
    obligatoire

    Integer numbers.

  • messages
    Type: array object[] · ClaudeMessage[] 1…
    obligatoire
    • content
      obligatoire
      • Type: string
    • role
      Type: string enum
      obligatoire
      valeurs
      • user
      • assistant
    • propertyName
      Type: anything
  • model
    Type: string
    obligatoire
  • metadata
    Type: object
    • propertyName
      Type: anything
  • service_tier
    Type: string | null

    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.

  • stop_sequences
    Type: array string[]
  • stream
    Type: boolean
  • system
    • Type: string
  • temperature
    Type: number
    min.:  
    0
    max.:  
    1
  • thinking
    Type: object
    • propertyName
      Type: anything
  • tool_choice
    • Type: string
  • tools
    Type: array object[]
    • propertyName
      Type: anything
  • propertyName
    Type: anything
  • top_k
    Type: integer
    min.:  
    0

    Integer numbers.

  • top_p
    Type: number
    min.:  
    0
    max.:  
    1
  • propertyName
    Type: anything
Réponses
  • 200
    Type: object · ClaudeMessageResponse

    Message Claude ou réponse en streaming

    • content
      Type: array object[] · ClaudeContentBlock[]
      obligatoire
      • type
        Type: string enum
        obligatoire
        valeurs
        • text
        • image
        • document
        • tool_use
        • tool_result
        • thinking
      • content
        Type: string | array
      • id
        Type: string
      • input
        Type: object
        • propertyName
          Type: anything
      • name
        Type: string
      • source
        Type: object
        • propertyName
          Type: anything
      • text
        Type: string
      • propertyName
        Type: anything
    • id
      Type: string
      obligatoire
    • model
      Type: string
      obligatoire
    • role
      constante:  
      assistant
      obligatoire
    • stop_reason
      Type: string | null
      obligatoire
    • type
      constante:  
      message
      obligatoire
    • stop_sequence
      Type: string | null
    • usage
      Type: object · Usage

      Objet d'utilisation du fournisseur. Les champs varient selon le point de terminaison et le fournisseur.

      • propertyName
        Type: anything
    • propertyName
      Type: anything
  • 400
    Type: object · ClaudeErrorResponse

    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.

    • error
      Type: object
      obligatoire
      • message
        Type: string
        obligatoire
      • type
        Type: string
        obligatoire
      • propertyName
        Type: anything
    • type
      constante:  
      error
      obligatoire
    • request_id
      Type: string
    • propertyName
      Type: anything
    application/json
  • 401
    Type: object · ClaudeErrorResponse

    Clé API Felo invalide ou manquante

    Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.

    • error
      Type: object
      obligatoire
      • message
        Type: string
        obligatoire
      • type
        Type: string
        obligatoire
      • propertyName
        Type: anything
    • type
      constante:  
      error
      obligatoire
    • request_id
      Type: string
    • propertyName
      Type: anything
    application/json
  • 402
    Type: object · ClaudeErrorResponse

    Solde insuffisant

    Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.

    • error
      Type: object
      obligatoire
      • message
        Type: string
        obligatoire
      • type
        Type: string
        obligatoire
      • propertyName
        Type: anything
    • type
      constante:  
      error
      obligatoire
    • request_id
      Type: string
    • propertyName
      Type: anything
    application/json
  • 403
    Type: object · ClaudeErrorResponse

    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.

    • error
      Type: object
      obligatoire
      • message
        Type: string
        obligatoire
      • type
        Type: string
        obligatoire
      • propertyName
        Type: anything
    • type
      constante:  
      error
      obligatoire
    • request_id
      Type: string
    • propertyName
      Type: anything
    application/json
  • 429
    Type: object · ClaudeErrorResponse

    Limite de dépenses ou de requêtes atteinte

    Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.

    • error
      Type: object
      obligatoire
      • message
        Type: string
        obligatoire
      • type
        Type: string
        obligatoire
      • propertyName
        Type: anything
    • type
      constante:  
      error
      obligatoire
    • request_id
      Type: string
    • propertyName
      Type: anything
    application/json
  • 502
    Type: object · ClaudeErrorResponse

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

    • error
      Type: object
      obligatoire
      • message
        Type: string
        obligatoire
      • type
        Type: string
        obligatoire
      • propertyName
        Type: anything
    • type
      constante:  
      error
      obligatoire
    • request_id
      Type: string
    • propertyName
      Type: anything
    application/json
  • 503
    Type: object · ClaudeErrorResponse

    Fournisseur ou service de facturation indisponible

    Enveloppe d'erreur compatible avec l'API Errors de Claude pour les requêtes Messages.

    • error
      Type: object
      obligatoire
      • message
        Type: string
        obligatoire
      • type
        Type: string
        obligatoire
      • propertyName
        Type: anything
    • type
      constante:  
      error
      obligatoire
    • request_id
      Type: string
    • propertyName
      Type: anything
    application/json
Request Example for post/api/v1/messages
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"
}
Create a Claude message