v0.4.0

OpenAPI 3.1.0

Creare un completamento chat

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

Creare un completamento chat

API Chat Completions compatibile con OpenAI. Impostare stream=true per ricevere Server-Sent Events. La risposta e la struttura degli errori seguono il formato Chat Completions/compatibile con OpenAI.

Intestazioni

X-Felo-Channel
Tipo: string

Codici canale pubblici separati da virgola e in ordine. Omettere questa intestazione per usare default; default deve essere usato da solo. In modalità wallet, default analizza in ordine inverso l'ordine effettivo dei canali pubblici del modello, ignora i canali non pubblicati o non disponibili e seleziona il provider del primo canale disponibile. Include gli endpoint disponibili di quel provider con lo stesso ID modello upstream e lo stesso livello di servizio. I canali espliciti vengono convalidati nell'ordine indicato dal client; viene inviato solo il gruppo di provider del primo canale. Nessun fallback automatico ad altri provider. Le intestazioni dei provider legacy non possono ignorare l'instradamento dei canali.

Corpo·ChatCompletionRequest

obbligatorio

application/json

messages
Tipo: array object[] · ChatMessage[] 1…
obbligatorio
- content
  ammette null
  obbligatorio
  Tipo: string
- role
  Tipo: string enum
  obbligatorio
  valori
  system
  developer
  user
  assistant
  tool
- name
  Tipo: string
- tool_call_id
  Tipo: string
- tool_calls
  Tipo: array object[]
  propertyName
  Tipo: anything
- propertyName
  Tipo: anything
model
Tipo: string
obbligatorio
max_completion_tokens
Tipo: integer
min:
1

Integer numbers.
max_tokens
Tipo: integer
min:
1

Integer numbers.
n
Tipo: integer
min:
1

Integer numbers.
response_format
Tipo: object
- propertyName
  Tipo: anything
service_tier
Tipo: string | null

Attualmente è supportato solo default (standard). Se omesso, null, alias e stringhe non supportate ricadono su default; altri tipi restituiscono HTTP 400. I canali e i prezzi configurati restano invariati. Le API di testo inviano il valore standard del provider; le API Decisions e di generazione omettono il campo upstream.
stop
ammette null
Tipo: string
stream
Tipo: boolean
temperature
Tipo: number
min:
0
tool_choice
Tipo: string
tools
Tipo: array object[]
- propertyName
  Tipo: anything
propertyName
Tipo: anything

top_p
Tipo: number
min:
0
max:
1
user
Tipo: string
propertyName
Tipo: anything

Risposte

200
Tipo: object · ChatCompletionResponse

Completamento chat o risposta in streaming
choices
Tipo: array object[] · ChatChoice[]
obbligatorio
finish_reason
Tipo: string | null
index
Tipo: integer

Integer numbers.

logprobs
Tipo: object | null
propertyName
Tipo: anything
message
Tipo: object · ChatMessage
content
ammette null
obbligatorio
Tipo: string
role
Tipo: string enum
obbligatorio
valori
system
developer
user
assistant
tool
name
Tipo: string
tool_call_id
Tipo: string
tool_calls
Tipo: array object[]
propertyName
Tipo: anything
propertyName
Tipo: anything
propertyName
Tipo: anything
id
Tipo: string
obbligatorio
object
Tipo: string
obbligatorio

Di solito chat.completion per le risposte non in streaming.

created
Tipo: integer Formato: int64

Signed 64-bit integers (long type).

model
Tipo: string
system_fingerprint
Tipo: string
usage
Tipo: object · Usage

Oggetto di utilizzo del provider. I campi variano in base all'endpoint e al provider.

propertyName
Tipo: anything
propertyName
Tipo: anything
400
Tipo: object · OpenAIErrorResponse

Richiesta, modello o mappatura del provider non validi

Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.
error
Tipo: object
obbligatorio
message
Tipo: string
obbligatorio
code
Tipo: string | null
param
Tipo: string | null
type
Tipo: string

Tipo di errore compatibile con OpenAI, se fornito.

propertyName
Tipo: anything
propertyName
Tipo: anything
application/json
401
Tipo: object · OpenAIErrorResponse

Chiave API Felo non valida o mancante

Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.
error
Tipo: object
obbligatorio
message
Tipo: string
obbligatorio
code
Tipo: string | null
param
Tipo: string | null
type
Tipo: string

Tipo di errore compatibile con OpenAI, se fornito.

propertyName
Tipo: anything
propertyName
Tipo: anything
application/json
402
Tipo: object · OpenAIErrorResponse

Saldo insufficiente

Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.
error
Tipo: object
obbligatorio
message
Tipo: string
obbligatorio
code
Tipo: string | null
param
Tipo: string | null
type
Tipo: string

Tipo di errore compatibile con OpenAI, se fornito.

propertyName
Tipo: anything
propertyName
Tipo: anything
application/json
403
Tipo: object · OpenAIErrorResponse

L'account non è autorizzato a usare il modello. Anche i modelli disattivati vengono rifiutati prima delle chiamate upstream. Le richieste e le attività già accettate proseguono.

Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.
error
Tipo: object
obbligatorio
message
Tipo: string
obbligatorio
code
Tipo: string | null
param
Tipo: string | null
type
Tipo: string

Tipo di errore compatibile con OpenAI, se fornito.

propertyName
Tipo: anything
propertyName
Tipo: anything
application/json
429
Tipo: object · OpenAIErrorResponse

Limite di spesa o di richieste raggiunto

Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.
error
Tipo: object
obbligatorio
message
Tipo: string
obbligatorio
code
Tipo: string | null
param
Tipo: string | null
type
Tipo: string

Tipo di errore compatibile con OpenAI, se fornito.

propertyName
Tipo: anything
propertyName
Tipo: anything
application/json
502
Tipo: object · OpenAIErrorResponse

Richiesta al provider upstream non riuscita

Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.
error
Tipo: object
obbligatorio
message
Tipo: string
obbligatorio
code
Tipo: string | null
param
Tipo: string | null
type
Tipo: string

Tipo di errore compatibile con OpenAI, se fornito.

propertyName
Tipo: anything
propertyName
Tipo: anything
application/json
503
Tipo: object · OpenAIErrorResponse

Provider o servizio di fatturazione non disponibile

Struttura di errore compatibile con OpenAI. Il Router può includere code e message senza tutti i campi upstream facoltativi.
error
Tipo: object
obbligatorio
message
Tipo: string
obbligatorio
code
Tipo: string | null
param
Tipo: string | null
type
Tipo: string

Tipo di errore compatibile con OpenAI, se fornito.

propertyName
Tipo: anything
propertyName
Tipo: anything
application/json

post/api/v1/chat/completions

curl https://openapi.felo.ai/api/v1/chat/completions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Write a one-sentence greeting."
    }
  ],
  "stream": false
}'

Mostra schema

{
  "id": "string",
  "object": "string",
  "created": 1,
  "model": "string",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "system",
        "content": "string",
        "name": "string",
        "tool_call_id": "string",
        "tool_calls": [
          {
            "additionalProperty": "anything"
          }
        ],
        "additionalProperty": "anything"
      },
      "finish_reason": null,
      "logprobs": null,
      "additionalProperty": "anything"
    }
  ],
  "usage": {
    "additionalProperty": "anything"
  },
  "system_fingerprint": "string",
  "additionalProperty": "anything"
}

Completamento chat o risposta in streaming

Creare un completamento chat

AutenticazioneRequired

Creare un completamento chat