Справочник API
Аудио
Пока ни одна модель это не поддерживает
/v1/audio/speech/v1/audio/transcriptions/v1/audio/translationsРечь в обе стороны: /v1/audio/speech синтезирует аудио из текста; /v1/audio/transcriptions превращает аудио в текст (совместимо с Whisper); /v1/audio/translations распознаёт речь сразу с переводом на английский.
#Параметры запроса
modelstringобязательноМодели класса tts-1 для синтеза речи; класса whisper-1 — для распознавания.
inputstringобязательноТолько для speech: текст для озвучки.
voicestringобязательноТолько для speech: имя голоса (alloy, nova, …); доступные голоса указаны в карточке модели.
filefile (multipart)обязательноТолько для transcriptions: аудиофайл (mp3, wav, m4a, webm …).
languagestringнеобязательноТолько для transcriptions: подсказка в формате ISO-639-1, повышающая точность.
response_formatstringнеобязательноspeech: mp3 | wav | opus …; transcriptions: json | text | srt | verbose_json.
speednumberнеобязательноТолько для speech: скорость воспроизведения 0.25–4.0.
Два разных типа содержимого
#Связанные ошибки
- 413 payload_too_largeТело запроса (промпт, изображение или аудиофайл) превышает допустимый размер.
- 401Bearer-токен недействителен или отсутствует. На этом пути error.code нет — ориентируйтесь на статус.
- 402 insufficient_user_quotaБаланса кошелька не хватает на предварительно резервируемую сумму.
- 429Ограничение частоты для ключа. Тело пустое; дождитесь Retry-After. Если же в ответе 429 есть insufficient_user_quota, это дневной лимит расходов.
- 503 model_not_foundНеизвестная модель, или сейчас её не обслуживает ни один исправный канал.
#Пример запроса
# text → speech (bytes saved to file)
curl https://www.aisplice.store/v1/audio/speech \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "tts-1", "voice": "alloy", "input": "Hello from the gateway."}' \
--output hello.mp3
# speech → text (multipart)
curl https://www.aisplice.store/v1/audio/transcriptions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-F file=@meeting.mp3 -F model=whisper-1#Ответ
// /v1/audio/speech → binary audio body (Content-Type: audio/mpeg)
// /v1/audio/transcriptions
{"text": "…transcript…"}Проблема не решена?
Пришлите нам ID запроса или текст ошибки, и мы разберёмся.