Gecko Voice

РуководствоДля разработчиков

API и ключи

Загрузить файл из своего кода и забрать текст с разбором.

apiключиинтеграции

Проверено 29 октября 2026 г.

Ключ

Откройте в веб-кабинете «Настройки → Интеграции» и создайте API-ключ. Там же — справочник методов с готовыми командами curl. Ключ передаётся заголовком:

http
Authorization: Bearer gv_…

Отозвать ключ можно в том же разделе. Расшифровки по API списываются с того же баланса, что и в боте и на сайте.

Как это работает

  1. init

    Открыть загрузку

  2. chunk

    Отправить части файла

  3. finalize

    Поставить в работу

  4. GET /transcriptions/:id

    Забрать результат

Файл до 1 ГБ загружается частями: обрыв связи не обнуляет загрузку, повтор части безопасен. Затем опрашивайте GET /api/transcriptions/:id, пока status не станет COMPLETED или FAILED.

bash
curl 'https://api.geckovoice.com/api/transcriptions/<id>' \
  -H 'Authorization: Bearer gv_…'

Что приходит в ответе

text, segments
Текст и фрагменты с тайм-кодами.
analysis, tasks
Разбор и задачи — приходят позже текста, следите за analysisStatus.
recognition
NO_SPEECH — речи не было, время не списано.
errorCode, retryable
Причина ошибки и стоит ли отправлять заново.

Полная схема — GET https://api.geckovoice.com/api/openapi.json, без ключа.