Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Eine Claude-Nachricht erstellen

Felo API Support
MIT
Server:https://openapi.felo.ai
Client-Bibliotheken
Shell Curl

Eine Claude-Nachricht erstellen

​

Claude-Messages-API-kompatibler Endpunkt. Setzen Sie stream=true, um Nachrichten-Streaming-Ereignisse im Claude-Stil zu empfangen. Felder für Anfrage, Antwort und Validierungsfehler folgen dem Claude-Messages-Protokoll; der Router kann bei Infrastrukturfehlern zusätzlich ein bereinigtes Gateway-Fehler-Envelope zurückgeben.

Header
  • X-Felo-Channel
    Typ: string

    Geordnete, durch Kommas getrennte öffentliche Kanalcodes. Lassen Sie diesen Header weg, um default zu verwenden; default muss allein verwendet werden. Im Wallet-Modus durchsucht default die effektive öffentliche Kanalreihenfolge des Modells in umgekehrter Reihenfolge, überspringt nicht veröffentlichte oder nicht verfügbare Kanäle und wählt den Anbieter des ersten verfügbaren Kanals. Der Wert default schließt verfügbare Endpunkte dieses Anbieters mit derselben Upstream-Modell-ID und demselben Service-Tier ein. Explizite Kanäle werden in der vom Client angegebenen Reihenfolge validiert; nur die Anbietergruppe des ersten Kanals wird übermittelt. Kein automatischer Fallback auf andere Anbieter. Legacy-Anbieter-Header können das Kanal-Routing nicht überschreiben.

Body·ClaudeMessagesRequest
erforderlich
application/json
  • max_tokens
    Typ: integer
    min.:  
    1
    erforderlich

    Integer numbers.

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

    Derzeit wird nur default (standard) unterstützt. Weggelassene Werte, null, Aliase und nicht unterstützte Zeichenfolgen fallen auf default zurück; andere Typen liefern HTTP 400. Konfigurierte Kanäle und Preise bleiben unverändert. Text-APIs senden den Standardwert des Anbieters; Decisions- und Generierungs-APIs lassen das Upstream-Feld weg.

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

    Integer numbers.

  • top_p
    Typ: number
    min.:  
    0
    max.:  
    1
  • propertyName
    Typ: anything
Antworten
  • 200
    Typ: object · ClaudeMessageResponse

    Claude-Nachricht oder Streaming-Antwort

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

      Nutzungsobjekt des Anbieters. Die Felder variieren je nach Endpunkt und Anbieter.

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

    Claude invalid_request_error oder Anfragevalidierungsfehler des Routers

    Claude-Errors-API-kompatibles Fehler-Envelope für Messages-Anfragen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • type
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • type
      Konstante:  
      error
      erforderlich
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 401
    Typ: object · ClaudeErrorResponse

    Ungültiger oder fehlender Felo-API-Schlüssel

    Claude-Errors-API-kompatibles Fehler-Envelope für Messages-Anfragen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • type
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • type
      Konstante:  
      error
      erforderlich
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 402
    Typ: object · ClaudeErrorResponse

    Unzureichendes Guthaben

    Claude-Errors-API-kompatibles Fehler-Envelope für Messages-Anfragen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • type
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • type
      Konstante:  
      error
      erforderlich
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 403
    Typ: object · ClaudeErrorResponse

    Das Konto ist nicht berechtigt, das Modell zu verwenden. Deaktivierte Modelle werden ebenfalls vor Upstream-Aufrufen abgelehnt. Bereits angenommene Anfragen und Aufgaben werden fortgesetzt.

    Claude-Errors-API-kompatibles Fehler-Envelope für Messages-Anfragen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • type
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • type
      Konstante:  
      error
      erforderlich
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 429
    Typ: object · ClaudeErrorResponse

    Ausgaben- oder Anfragelimit erreicht

    Claude-Errors-API-kompatibles Fehler-Envelope für Messages-Anfragen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • type
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • type
      Konstante:  
      error
      erforderlich
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 502
    Typ: object · ClaudeErrorResponse

    Anfrage an den Upstream-Anbieter fehlgeschlagen

    Claude-Errors-API-kompatibles Fehler-Envelope für Messages-Anfragen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • type
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • type
      Konstante:  
      error
      erforderlich
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 503
    Typ: object · ClaudeErrorResponse

    Anbieter- oder Abrechnungsdienst nicht verfügbar

    Claude-Errors-API-kompatibles Fehler-Envelope für Messages-Anfragen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • type
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • type
      Konstante:  
      error
      erforderlich
    • request_id
      Typ: string
    • propertyName
      Typ: 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"
}

Claude-Nachricht oder Streaming-Antwort

Create a Claude message