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 — проверенную стоимость поставщика с опубликованной наценкой и скидкой.
- Тип: stringX
- Felo - Channel 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.
- Тип: object200
Синхронный JSON содержит
textи необязательныйusageв секундах или token.usage.cost— затраты поставщика, а не окончательное списание Felo. Опрос задачи не нужен.- Тип: stringtextобязательно
- Тип: object | nullusage
- costТип: numberмин.:0
Reported upstream cost in USD.
- inputТип: object
_token _details - audioТип: integer
_tokens мин.:0Integer numbers.
- textТип: integer
_tokens мин.:0Integer numbers.
- inputТип: integer
_tokens мин.:0Integer numbers.
- outputТип: integer
_tokens мин.:0Integer numbers.
- secondsТип: numberмин.:0
Duration reported by the selected channel.
- totalТип: integer
_tokens мин.:0Integer numbers.
- typeТип: string enumзначения
- duration
- tokens
application/json - Тип: object400
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object402
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object413
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object415
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object429
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object500
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object502
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object503
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json - Тип: object504
Upload, wallet or upstream error
- Тип: objecterrorобязательно
- codeТип: string | null
- messageТип: string
- paramТип: string | null
- typeТип: string
application/json
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
}
}