Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Eine Modellantwort erstellen

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

Eine Modellantwort erstellen

​

OpenAI-Responses-API-kompatibler Endpunkt. Eine erfolgreiche Nicht-Streaming-Antwort verwendet die Form des Antwortobjekts; bei stream=true gibt der Endpunkt Responses-SSE-Ereignisse zurück. Ein fehlgeschlagenes Antwortobjekt kann status=failed mit error={code,message} verwenden, auch wenn die HTTP-Anfrage selbst abgeschlossen wurde.

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·ResponsesRequest
erforderlich
application/json
  • input
    erforderlich
    • Typ: string
  • model
    Typ: string
    erforderlich
  • include
    Typ: array string[]
  • instructions
    Typ: string
  • max_output_tokens
    Typ: integer
    min.:  
    1

    Integer numbers.

  • metadata
    Typ: object
    • propertyName
      Typ: anything
  • previous_response_id
    Typ: string
  • reasoning
    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.

  • store
    Typ: boolean
  • stream
    Typ: boolean
  • temperature
    Typ: number
    min.:  
    0
  • propertyName
    Typ: anything
  • text
    Typ: object
    • propertyName
      Typ: anything
  • tool_choice
    • Typ: string
  • tools
    Typ: array object[]
    • propertyName
      Typ: anything
  • top_p
    Typ: number
    min.:  
    0
    max.:  
    1
  • propertyName
    Typ: anything
Antworten
  • 200
    Typ: object · ResponsesResponse

    Antwortobjekt oder Streaming-Antwort-Ereignisse

    • id
      Typ: string
      erforderlich
    • object
      Konstante:  
      response
      erforderlich
    • status
      Typ: string enum
      erforderlich
      Werte
      • completed
      • failed
      • in_progress
      • cancelled
      • queued
      • incomplete
    • error
      Typ: object · ResponsesError
      • code
        Typ: string
        erforderlich
      • message
        Typ: string
        erforderlich
      • propertyName
        Typ: anything
    • metadata
      Typ: object
      • propertyName
        Typ: anything
    • model
      Typ: string
    • output
      Typ: array object[]
      • propertyName
        Typ: anything
    • output_text
      Typ: string
    • usage
      Typ: object · Usage

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

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

    Ungültige Anfrage, ungültiges Modell oder ungültige Anbieterzuordnung

    OpenAI-kompatibles Fehler-Envelope. Der Router kann code und message ohne alle optionalen Upstream-Felder einschließen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • code
        Typ: string | null
      • param
        Typ: string | null
      • type
        Typ: string

        OpenAI-kompatibler Fehlertyp, sofern angegeben.

      • propertyName
        Typ: anything
    • propertyName
      Typ: anything
    application/json
  • 401
    Typ: object · OpenAIErrorResponse

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

    OpenAI-kompatibles Fehler-Envelope. Der Router kann code und message ohne alle optionalen Upstream-Felder einschließen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • code
        Typ: string | null
      • param
        Typ: string | null
      • type
        Typ: string

        OpenAI-kompatibler Fehlertyp, sofern angegeben.

      • propertyName
        Typ: anything
    • propertyName
      Typ: anything
    application/json
  • 402
    Typ: object · OpenAIErrorResponse

    Unzureichendes Guthaben

    OpenAI-kompatibles Fehler-Envelope. Der Router kann code und message ohne alle optionalen Upstream-Felder einschließen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • code
        Typ: string | null
      • param
        Typ: string | null
      • type
        Typ: string

        OpenAI-kompatibler Fehlertyp, sofern angegeben.

      • propertyName
        Typ: anything
    • propertyName
      Typ: anything
    application/json
  • 403
    Typ: object · OpenAIErrorResponse

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

    OpenAI-kompatibles Fehler-Envelope. Der Router kann code und message ohne alle optionalen Upstream-Felder einschließen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • code
        Typ: string | null
      • param
        Typ: string | null
      • type
        Typ: string

        OpenAI-kompatibler Fehlertyp, sofern angegeben.

      • propertyName
        Typ: anything
    • propertyName
      Typ: anything
    application/json
  • 429
    Typ: object · OpenAIErrorResponse

    Ausgaben- oder Anfragelimit erreicht

    OpenAI-kompatibles Fehler-Envelope. Der Router kann code und message ohne alle optionalen Upstream-Felder einschließen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • code
        Typ: string | null
      • param
        Typ: string | null
      • type
        Typ: string

        OpenAI-kompatibler Fehlertyp, sofern angegeben.

      • propertyName
        Typ: anything
    • propertyName
      Typ: anything
    application/json
  • 502
    Typ: object · OpenAIErrorResponse

    Anfrage an den Upstream-Anbieter fehlgeschlagen

    OpenAI-kompatibles Fehler-Envelope. Der Router kann code und message ohne alle optionalen Upstream-Felder einschließen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • code
        Typ: string | null
      • param
        Typ: string | null
      • type
        Typ: string

        OpenAI-kompatibler Fehlertyp, sofern angegeben.

      • propertyName
        Typ: anything
    • propertyName
      Typ: anything
    application/json
  • 503
    Typ: object · OpenAIErrorResponse

    Anbieter- oder Abrechnungsdienst nicht verfügbar

    OpenAI-kompatibles Fehler-Envelope. Der Router kann code und message ohne alle optionalen Upstream-Felder einschließen.

    • error
      Typ: object
      erforderlich
      • message
        Typ: string
        erforderlich
      • code
        Typ: string | null
      • param
        Typ: string | null
      • type
        Typ: string

        OpenAI-kompatibler Fehlertyp, sofern angegeben.

      • propertyName
        Typ: anything
    • propertyName
      Typ: anything
    application/json
Request Example for post/api/v1/responses
curl https://openapi.felo.ai/api/v1/responses \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "gpt-5.5",
  "input": "Explain why the sky is blue in one sentence.",
  "stream": false
}'

{
  "id": "string",
  "object": "response",
  "status": "completed",
  "output": [
    {
      "additionalProperty": "anything"
    }
  ],
  "output_text": "string",
  "error": {
    "code": "string",
    "message": "string",
    "additionalProperty": "anything"
  },
  "usage": {
    "additionalProperty": "anything"
  },
  "model": "string",
  "metadata": {
    "additionalProperty": "anything"
  },
  "additionalProperty": "anything"
}

Antwortobjekt oder Streaming-Antwort-Ereignisse

Create a model response