Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Vytvořit zprávu Claude

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

Vytvořit zprávu Claude

​

Endpoint kompatibilní s rozhraním Claude Messages API. Nastavením stream=true získáte události streamu zpráv ve stylu Claude. Pole požadavku, odpovědi a chyb ověření odpovídají protokolu Claude Messages; Router může při selhání infrastruktury vrátit také očištěnou obálku chyby brány.

Hlavičky
  • X-Felo-Channel
    Typ: string

    Seřazené kódy veřejných kanálů oddělené čárkami. Pokud tuto hlavičku vynecháte, použije se default; default lze použít pouze samostatně. V režimu peněženky prochází default efektivní pořadí veřejných kanálů modelu v opačném směru, přeskakuje nepublikované nebo nedostupné kanály a vybere poskytovatele prvního dostupného kanálu. Zahrnuje dostupné endpointy tohoto poskytovatele se stejným ID modelu v upstreamu a stejnou úrovní služby. Explicitní kanály se ověřují v pořadí zadaném klientem; odešle se pouze skupina poskytovatele prvního kanálu. K automatickému přepnutí na jiné poskytovatele nedochází. Starší hlavičky poskytovatele nemohou přepsat směrování kanálů.

Tělo·ClaudeMessagesRequest
povinné
application/json
  • max_tokens
    Typ: integer
    min:  
    1
    povinné

    Integer numbers.

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

    V současnosti je podporována pouze hodnota default (standard). Vynechaná hodnota, null, aliasy a nepodporované řetězce se převedou na default; jiné typy vrací HTTP 400. Nakonfigurované kanály a ceny zůstávají beze změny. Textová API odesílají standardní hodnotu poskytovatele; rozhraní Decisions a rozhraní generování pole upstreamu vynechávají.

  • 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
Odpovědi
  • 200
    Typ: object · ClaudeMessageResponse

    Zpráva Claude nebo streamovaná odpověď

    • content
      Typ: array object[] · ClaudeContentBlock[]
      povinné
      • type
        Typ: string enum
        povinné
        hodnoty
        • 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
      povinné
    • model
      Typ: string
      povinné
    • role
      const:  
      assistant
      povinné
    • stop_reason
      Typ: string | null
      povinné
    • type
      const:  
      message
      povinné
    • stop_sequence
      Typ: string | null
    • usage
      Typ: object · Usage

      Objekt využití od poskytovatele. Pole se liší podle endpointu a poskytovatele.

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

    Chyba invalid_request_error od Claude nebo chyba ověření požadavku v Routeru

    Obálka chyb kompatibilní s rozhraním Claude Errors API pro požadavky Messages.

    • error
      Typ: object
      povinné
      • message
        Typ: string
        povinné
      • type
        Typ: string
        povinné
      • propertyName
        Typ: anything
    • type
      const:  
      error
      povinné
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 401
    Typ: object · ClaudeErrorResponse

    Neplatný nebo chybějící API klíč Felo

    Obálka chyb kompatibilní s rozhraním Claude Errors API pro požadavky Messages.

    • error
      Typ: object
      povinné
      • message
        Typ: string
        povinné
      • type
        Typ: string
        povinné
      • propertyName
        Typ: anything
    • type
      const:  
      error
      povinné
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 402
    Typ: object · ClaudeErrorResponse

    Nedostatečný zůstatek

    Obálka chyb kompatibilní s rozhraním Claude Errors API pro požadavky Messages.

    • error
      Typ: object
      povinné
      • message
        Typ: string
        povinné
      • type
        Typ: string
        povinné
      • propertyName
        Typ: anything
    • type
      const:  
      error
      povinné
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 403
    Typ: object · ClaudeErrorResponse

    Účet nemá oprávnění model používat. Zakázané modely se odmítají ještě před voláním upstreamu. Již přijaté požadavky a úlohy pokračují.

    Obálka chyb kompatibilní s rozhraním Claude Errors API pro požadavky Messages.

    • error
      Typ: object
      povinné
      • message
        Typ: string
        povinné
      • type
        Typ: string
        povinné
      • propertyName
        Typ: anything
    • type
      const:  
      error
      povinné
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 429
    Typ: object · ClaudeErrorResponse

    Dosažen limit utrácení nebo požadavků

    Obálka chyb kompatibilní s rozhraním Claude Errors API pro požadavky Messages.

    • error
      Typ: object
      povinné
      • message
        Typ: string
        povinné
      • type
        Typ: string
        povinné
      • propertyName
        Typ: anything
    • type
      const:  
      error
      povinné
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 502
    Typ: object · ClaudeErrorResponse

    Požadavek na poskytovatele upstream selhal

    Obálka chyb kompatibilní s rozhraním Claude Errors API pro požadavky Messages.

    • error
      Typ: object
      povinné
      • message
        Typ: string
        povinné
      • type
        Typ: string
        povinné
      • propertyName
        Typ: anything
    • type
      const:  
      error
      povinné
    • request_id
      Typ: string
    • propertyName
      Typ: anything
    application/json
  • 503
    Typ: object · ClaudeErrorResponse

    Poskytovatel nebo fakturační služba nejsou dostupné

    Obálka chyb kompatibilní s rozhraním Claude Errors API pro požadavky Messages.

    • error
      Typ: object
      povinné
      • message
        Typ: string
        povinné
      • type
        Typ: string
        povinné
      • propertyName
        Typ: anything
    • type
      const:  
      error
      povinné
    • 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"
}

Zpráva Claude nebo streamovaná odpověď

Create a Claude message