Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Распознавание речи

Сервер:https://openapi.felo.ai
Клиентские библиотеки

Audio

​
Audio Операции

Распознавание речи

​

Передайте model и file как multipart/form-data: полный моно PCM WAV, не более 25,000,000 байт, с учётом ограничений канала по частоте и длительности. Необязательны language (две строчные буквы, например ru) и response_format=json (единственный формат, также по умолчанию). boundary формирует curl. URL, ID файлов, prompt, временные метки и stream не поддерживаются.

STT оплачивается по input_audio_second или token, TTS — по input_character. speech_billing_unit: utf16_code_unit и unicode_code_point по-разному считают emoji. Резерв не является пределом расходов; расчёт может быть асинхронным. Отсутствие данных не означает бесплатность. Оба API принимают X-Felo-Channel и отправляют запрос в выбранный канал один раз. Отключите автоматические повторы после таймаута или обрыва, включая SDK; сохраните X-Request-Id и доступный X-Generation-Id. Console Playground пока не поддерживает аудио. configured_rates использует зафиксированные ставки и подтверждённый объём; upstream_cost — проверенную стоимость поставщика с опубликованной наценкой и скидкой.

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

    Ordered comma-separated public channel codes. Omit this header to use default; default must be used alone. In wallet mode, default scans the model's effective public channel order in reverse, skips unpublished or unavailable channels, and uses the first eligible channel. Explicit codes follow the supplied order. For stateless Chat Completions, Messages and Responses, the server may try another selected channel or provider group after a confirmed upstream rejection. A single explicit channel limits routing to that channel. Legacy provider headers cannot override channel routing.

Тело
обязательно
application/json
Ответы
  • 200
    Тип: object

    Синхронный JSON содержит text и необязательный usage в секундах или token. usage.cost — затраты поставщика, а не окончательное списание Felo. Опрос задачи не нужен.

    • text
      Тип: string
      обязательно
    • usage
      Тип: object | null
      • cost
        Тип: number
        мин.:  
        0

        Reported upstream cost in USD.

      • input_token_details
        Тип: object
        • audio_tokens
          Тип: integer
          мин.:  
          0

          Integer numbers.

        • text_tokens
          Тип: integer
          мин.:  
          0

          Integer numbers.

      • input_tokens
        Тип: integer
        мин.:  
        0

        Integer numbers.

      • output_tokens
        Тип: integer
        мин.:  
        0

        Integer numbers.

      • seconds
        Тип: number
        мин.:  
        0

        Duration reported by the selected channel.

      • total_tokens
        Тип: integer
        мин.:  
        0

        Integer numbers.

      • type
        Тип: string enum
        значения
        • duration
        • tokens
    application/json
  • 400
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 402
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 413
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 415
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 429
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 500
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 502
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 503
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
  • 504
    Тип: object

    Upload, wallet or upstream error

    • error
      Тип: object
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string
      • param
        Тип: string | null
      • type
        Тип: string
    application/json
Request Example for post/api/v1/audio/transcriptions
curl https://openapi.felo.ai/api/v1/audio/transcriptions \
  --request POST \
  --header 'Content-Type: multipart/form-data' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --form 'model=grok-stt-2.0' \
  --form 'file=@filename' \
  --form 'language=' \
  --form 'response_format=json'
{
  "text": "string",
  "usage": {
    "seconds": 0,
    "type": "duration",
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0,
    "input_token_details": {
      "text_tokens": 0,
      "audio_tokens": 0
    },
    "cost": 0
  }
}
Transcribe a WAV recording

Нужна помощь?