v0.4.0

OpenAPI 3.1.0

Utwórz uzupełnienie czatu

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

Utwórz uzupełnienie czatu

Interfejs API Chat Completions zgodny z OpenAI. Ustaw stream=true, aby otrzymywać zdarzenia Server-Sent Events. Odpowiedź i koperta błędów mają format Chat Completions zgodny z OpenAI.

Nagłówki

X-Felo-Channel
Typ: string

Uporządkowane kody publicznych kanałów rozdzielone przecinkami. Pomiń ten nagłówek, aby użyć wartości domyślnej; wartość domyślna musi być używana samodzielnie. W trybie portfela wartość domyślna przegląda efektywną kolejność publicznych kanałów modelu od końca, pomija kanały nieopublikowane lub niedostępne i wybiera dostawcę pierwszego dostępnego kanału. Obejmuje dostępne endpointy tego dostawcy o tym samym identyfikatorze modelu upstream i tym samym poziomie usługi. Jawne kanały są weryfikowane w kolejności podanej przez klienta; przesyłana jest tylko grupa dostawcy pierwszego kanału. Brak automatycznego przełączania na innych dostawców. Przestarzałe nagłówki dostawcy nie mogą nadpisać routingu kanałów.

Treść·ChatCompletionRequest

wymagane

application/json

messages
Typ: array object[] · ChatMessage[] 1…
wymagane
- content
  dopuszcza null
  wymagane
  Typ: string
- role
  Typ: string enum
  wymagane
  wartości
  system
  developer
  user
  assistant
  tool
- name
  Typ: string
- tool_call_id
  Typ: string
- tool_calls
  Typ: array object[]
  propertyName
  Typ: anything
- propertyName
  Typ: anything
model
Typ: string
wymagane
max_completion_tokens
Typ: integer
min.:
1

Integer numbers.
max_tokens
Typ: integer
min.:
1

Integer numbers.
n
Typ: integer
min.:
1

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

Obecnie obsługiwana jest tylko wartość default (standard). Pominięcie, null, aliasy i nieobsługiwane ciągi znaków powodują powrót do wartości default; inne typy zwracają HTTP 400. Skonfigurowane kanały i ceny pozostają bez zmian. Interfejsy API modeli tekstowych wysyłają standardową wartość dostawcy; interfejsy Decisions i generowania pomijają pole upstream.
stop
dopuszcza null
Typ: string
stream
Typ: boolean
temperature
Typ: number
min.:
0
tool_choice
Typ: string
tools
Typ: array object[]
- propertyName
  Typ: anything
propertyName
Typ: anything

top_p
Typ: number
min.:
0
maks.:
1
user
Typ: string
propertyName
Typ: anything

Odpowiedzi

200
Typ: object · ChatCompletionResponse

Uzupełnienie czatu lub odpowiedź strumieniowa
choices
Typ: array object[] · ChatChoice[]
wymagane
finish_reason
Typ: string | null
index
Typ: integer

Integer numbers.

logprobs
Typ: object | null
propertyName
Typ: anything
message
Typ: object · ChatMessage
content
dopuszcza null
wymagane
Typ: string
role
Typ: string enum
wymagane
wartości
system
developer
user
assistant
tool
name
Typ: string
tool_call_id
Typ: string
tool_calls
Typ: array object[]
propertyName
Typ: anything
propertyName
Typ: anything
propertyName
Typ: anything
id
Typ: string
wymagane
object
Typ: string
wymagane

Zwykle chat.completion w przypadku odpowiedzi niebędących strumieniem.

created
Typ: integer Format: int64

Signed 64-bit integers (long type).

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

Obiekt użycia dostawcy. Pola różnią się w zależności od endpointu i dostawcy.

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

Nieprawidłowe żądanie, model lub mapowanie dostawcy

Koperta błędu zgodna z OpenAI. Router może zwrócić code i message bez wszystkich opcjonalnych pól upstream.
error
Typ: object
wymagane
message
Typ: string
wymagane
code
Typ: string | null
param
Typ: string | null
type
Typ: string

Typ błędu zgodny z OpenAI, jeśli został podany.

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

Nieprawidłowy lub brakujący klucz API Felo

Koperta błędu zgodna z OpenAI. Router może zwrócić code i message bez wszystkich opcjonalnych pól upstream.
error
Typ: object
wymagane
message
Typ: string
wymagane
code
Typ: string | null
param
Typ: string | null
type
Typ: string

Typ błędu zgodny z OpenAI, jeśli został podany.

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

Niewystarczające saldo

Koperta błędu zgodna z OpenAI. Router może zwrócić code i message bez wszystkich opcjonalnych pól upstream.
error
Typ: object
wymagane
message
Typ: string
wymagane
code
Typ: string | null
param
Typ: string | null
type
Typ: string

Typ błędu zgodny z OpenAI, jeśli został podany.

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

Konto nie ma uprawnień do korzystania z modelu. Wyłączone modele są również odrzucane przed wywołaniami upstream. Istniejące przyjęte żądania i zadania są kontynuowane.

Koperta błędu zgodna z OpenAI. Router może zwrócić code i message bez wszystkich opcjonalnych pól upstream.
error
Typ: object
wymagane
message
Typ: string
wymagane
code
Typ: string | null
param
Typ: string | null
type
Typ: string

Typ błędu zgodny z OpenAI, jeśli został podany.

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

Osiągnięto limit wydatków lub żądań

Koperta błędu zgodna z OpenAI. Router może zwrócić code i message bez wszystkich opcjonalnych pól upstream.
error
Typ: object
wymagane
message
Typ: string
wymagane
code
Typ: string | null
param
Typ: string | null
type
Typ: string

Typ błędu zgodny z OpenAI, jeśli został podany.

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

Żądanie do dostawcy upstream nie powiodło się

Koperta błędu zgodna z OpenAI. Router może zwrócić code i message bez wszystkich opcjonalnych pól upstream.
error
Typ: object
wymagane
message
Typ: string
wymagane
code
Typ: string | null
param
Typ: string | null
type
Typ: string

Typ błędu zgodny z OpenAI, jeśli został podany.

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

Dostawca lub usługa rozliczeniowa niedostępna

Koperta błędu zgodna z OpenAI. Router może zwrócić code i message bez wszystkich opcjonalnych pól upstream.
error
Typ: object
wymagane
message
Typ: string
wymagane
code
Typ: string | null
param
Typ: string | null
type
Typ: string

Typ błędu zgodny z OpenAI, jeśli został podany.

propertyName
Typ: anything
propertyName
Typ: 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
}'

Pokaż schemat

{
  "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"
}

Uzupełnienie czatu lub odpowiedź strumieniowa

Utwórz uzupełnienie czatu

UwierzytelnianieRequired

Utwórz uzupełnienie czatu