Gecko Voice

GuideFor developers

API and keys

Upload a file from your code and fetch the text with its breakdown.

apikeysintegrations

Reviewed October 29, 2026

Key

In the web app, open Settings → Integrations and create an API key. The same page has a reference of methods with ready curl commands. Pass the key in a header:

http
Authorization: Bearer gv_…

You can revoke a key on the same page. API transcriptions are charged to the same balance as the bot and the website.

How it works

  1. init

    Open an upload

  2. chunk

    Send file parts

  3. finalize

    Start processing

  4. GET /transcriptions/:id

    Fetch the result

A file up to 1 GB is uploaded in parts: a dropped connection doesn't reset the upload, and retrying a part is safe. Then poll GET /api/transcriptions/:id until status is COMPLETED or FAILED.

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

What the response contains

text, segments
The text and timestamped segments.
analysis, tasks
The breakdown and tasks — they arrive after the text; watch analysisStatus.
recognition
NO_SPEECH — there was no speech, no time was charged.
errorCode, retryable
Why it failed and whether to send it again.

The full schema is at GET https://api.geckovoice.com/api/openapi.json, no key needed.