Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Створити відповідь моделі

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

Створити відповідь моделі

​

Ендпоінт, сумісний з API OpenAI Responses. Успішна непотокова відповідь має форму об'єкта Responses; якщо stream=true, ендпоінт повертає події SSE Responses. Невдалий об'єкт Responses може містити status=failed і error={code,message}, навіть якщо сам HTTP-запит завершився.

Заголовки
  • X-Felo-Channel
    Тип: string

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

Тіло·ResponsesRequest
обов'язкове
application/json
  • input
    обов'язкове
    • Тип: string
  • model
    Тип: string
    обов'язкове
  • include
    Тип: array string[]
  • instructions
    Тип: string
  • max_output_tokens
    Тип: integer
    мін.:  
    1

    Integer numbers.

  • metadata
    Тип: object
    • propertyName
      Тип: anything
  • previous_response_id
    Тип: string
  • reasoning
    Тип: object
    • propertyName
      Тип: anything
  • service_tier
    Тип: string | null

    Наразі підтримується лише default (standard). Пропущене значення, null, псевдоніми та непідтримувані рядки замінюються на default; інші типи повертають HTTP 400. Налаштовані канали й ціни залишаються без змін. Текстові API надсилають стандартне значення постачальника; API Decisions і генерації пропускають поле апстріму.

  • store
    Тип: boolean
  • stream
    Тип: boolean
  • temperature
    Тип: number
    мін.:  
    0
  • propertyName
    Тип: anything
  • text
    Тип: object
    • propertyName
      Тип: anything
  • tool_choice
    • Тип: string
  • tools
    Тип: array object[]
    • propertyName
      Тип: anything
  • top_p
    Тип: number
    мін.:  
    0
    макс.:  
    1
  • propertyName
    Тип: anything
Відповіді
  • 200
    Тип: object · ResponsesResponse

    Об'єкт відповіді або події потокової відповіді

    • id
      Тип: string
      обов'язкове
    • object
      константа:  
      response
      обов'язкове
    • status
      Тип: string перелік
      обов'язкове
      значення
      • completed
      • failed
      • in_progress
      • cancelled
      • queued
      • incomplete
    • error
      Тип: object · ResponsesError
      • code
        Тип: string
        обов'язкове
      • message
        Тип: string
        обов'язкове
      • propertyName
        Тип: anything
    • metadata
      Тип: object
      • propertyName
        Тип: anything
    • model
      Тип: string
    • output
      Тип: array object[]
      • propertyName
        Тип: anything
    • output_text
      Тип: 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
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"
}

Об'єкт відповіді або події потокової відповіді

Create a model response