v0.4.0

OpenAPI 3.1.0

Створити відповідь чату

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клієнтські бібліотеки

Shell Curl

Створити відповідь чату

API Chat Completions, сумісний з OpenAI. Установіть stream=true, щоб отримувати події Server-Sent Events. Відповідь і конверт помилки відповідають формі Chat Completions, сумісній з OpenAI.

Заголовки

X-Felo-Channel
Тип: string

Упорядкований список публічних кодів каналів, розділених комами. Щоб використовувати стандартний канал, не передавайте цей заголовок; значення default потрібно вказувати окремо. У режимі гаманця default переглядає ефективний порядок публічних каналів моделі у зворотному напрямку, пропускає неопубліковані або недоступні канали та обирає постачальника першого доступного каналу. Він охоплює доступні ендпоінти цього постачальника з тим самим ID моделі в апстрімі та рівнем обслуговування. Явно вказані канали перевіряються в порядку, заданому клієнтом; надсилається лише група постачальника першого каналу. Автоматичного переходу до інших постачальників немає. Застарілі заголовки постачальника не можуть перевизначити маршрутизацію каналів.

Тіло·ChatCompletionRequest

обов'язкове

application/json

messages
Тип: array object[] · ChatMessage[] 1…
обов'язкове
- content
  допускає null
  обов'язкове
  Тип: string
- role
  Тип: string перелік
  обов'язкове
  значення
  system
  developer
  user
  assistant
  tool
- name
  Тип: string
- tool_call_id
  Тип: string
- tool_calls
  Тип: array object[]
  propertyName
  Тип: anything
- propertyName
  Тип: anything
model
Тип: string
обов'язкове
max_completion_tokens
Тип: integer
мін.:
1

Integer numbers.
max_tokens
Тип: integer
мін.:
1

Integer numbers.
n
Тип: integer
мін.:
1

Integer numbers.
response_format
Тип: object
- propertyName
  Тип: anything
service_tier
Тип: string | null

Наразі підтримується лише default (standard). Пропущене значення, null, псевдоніми та непідтримувані рядки замінюються на default; інші типи повертають HTTP 400. Налаштовані канали й ціни залишаються без змін. Текстові API надсилають стандартне значення постачальника; API Decisions і генерації пропускають поле апстріму.
stop
допускає null
Тип: string
stream
Тип: boolean
temperature
Тип: number
мін.:
0
tool_choice
Тип: string
tools
Тип: array object[]
- propertyName
  Тип: anything
propertyName
Тип: anything

top_p
Тип: number
мін.:
0
макс.:
1
user
Тип: string
propertyName
Тип: anything

Відповіді

200
Тип: object · ChatCompletionResponse

Відповідь чату або потокова відповідь
choices
Тип: array object[] · ChatChoice[]
обов'язкове
finish_reason
Тип: string | null
index
Тип: integer

Integer numbers.

logprobs
Тип: object | null
propertyName
Тип: anything
message
Тип: object · ChatMessage
content
допускає null
обов'язкове
Тип: string
role
Тип: string перелік
обов'язкове
значення
system
developer
user
assistant
tool
name
Тип: string
tool_call_id
Тип: string
tool_calls
Тип: array object[]
propertyName
Тип: anything
propertyName
Тип: anything
propertyName
Тип: anything
id
Тип: string
обов'язкове
object
Тип: string
обов'язкове

Зазвичай chat.completion для непотокових відповідей.

created
Тип: integer Формат: int64

Signed 64-bit integers (long type).

model
Тип: string
system_fingerprint
Тип: string
usage
Тип: object · Usage

Об'єкт використання від постачальника. Поля залежать від ендпоінта й постачальника.

propertyName
Тип: anything
propertyName
Тип: anything
400
Тип: object · OpenAIErrorResponse

Некоректний запит, модель або зіставлення постачальника

Конверт помилки, сумісний з OpenAI. Router може містити code і message без усіх необов'язкових полів апстріму.
error
Тип: object
обов'язкове
message
Тип: string
обов'язкове
code
Тип: string | null
param
Тип: string | null
type
Тип: string

Тип помилки, сумісний з OpenAI, якщо його надано.

propertyName
Тип: anything
propertyName
Тип: anything
application/json
401
Тип: object · OpenAIErrorResponse

Недійсний або відсутній API-ключ Felo

Конверт помилки, сумісний з OpenAI. Router може містити code і message без усіх необов'язкових полів апстріму.
error
Тип: object
обов'язкове
message
Тип: string
обов'язкове
code
Тип: string | null
param
Тип: string | null
type
Тип: string

Тип помилки, сумісний з OpenAI, якщо його надано.

propertyName
Тип: anything
propertyName
Тип: anything
application/json
402
Тип: object · OpenAIErrorResponse

Недостатній баланс

Конверт помилки, сумісний з OpenAI. Router може містити code і message без усіх необов'язкових полів апстріму.
error
Тип: object
обов'язкове
message
Тип: string
обов'язкове
code
Тип: string | null
param
Тип: string | null
type
Тип: string

Тип помилки, сумісний з OpenAI, якщо його надано.

propertyName
Тип: anything
propertyName
Тип: anything
application/json
403
Тип: object · OpenAIErrorResponse

Обліковий запис не має дозволу на використання моделі. Вимкнені моделі також відхиляються до викликів до апстріму. Уже прийняті запити та завдання продовжують виконуватися.

Конверт помилки, сумісний з OpenAI. Router може містити code і message без усіх необов'язкових полів апстріму.
error
Тип: object
обов'язкове
message
Тип: string
обов'язкове
code
Тип: string | null
param
Тип: string | null
type
Тип: string

Тип помилки, сумісний з OpenAI, якщо його надано.

propertyName
Тип: anything
propertyName
Тип: anything
application/json
429
Тип: object · OpenAIErrorResponse

Досягнуто ліміту витрат або запитів

Конверт помилки, сумісний з OpenAI. Router може містити code і message без усіх необов'язкових полів апстріму.
error
Тип: object
обов'язкове
message
Тип: string
обов'язкове
code
Тип: string | null
param
Тип: string | null
type
Тип: string

Тип помилки, сумісний з OpenAI, якщо його надано.

propertyName
Тип: anything
propertyName
Тип: anything
application/json
502
Тип: object · OpenAIErrorResponse

Запит до постачальника в апстрімі не вдався

Конверт помилки, сумісний з OpenAI. Router може містити code і message без усіх необов'язкових полів апстріму.
error
Тип: object
обов'язкове
message
Тип: string
обов'язкове
code
Тип: string | null
param
Тип: string | null
type
Тип: string

Тип помилки, сумісний з OpenAI, якщо його надано.

propertyName
Тип: anything
propertyName
Тип: anything
application/json
503
Тип: object · OpenAIErrorResponse

Постачальник або служба білінгу недоступні

Конверт помилки, сумісний з OpenAI. Router може містити code і message без усіх необов'язкових полів апстріму.
error
Тип: object
обов'язкове
message
Тип: string
обов'язкове
code
Тип: string | null
param
Тип: string | null
type
Тип: string

Тип помилки, сумісний з OpenAI, якщо його надано.

propertyName
Тип: anything
propertyName
Тип: 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
}'

Показати схему

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

Відповідь чату або потокова відповідь

Створити відповідь чату

АвтентифікаціяRequired

Створити відповідь чату