Developers

API overview

Three calls get you from an audio file to a transcript. Full reference docs will be published at launch.

1. Create a job

curl -X POST https://api.lohevox.cloud/v1/jobs \
  -H "Authorization: Bearer $LOHEVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename":"interview.m4a","size_bytes":734003200,
       "language":"auto","formats":["srt","json"],
       "webhook_url":"https://example.com/hooks/lohevox"}'

The response contains a job_id and signed URLs for each upload part.

2. Upload and complete

# PUT each part to its signed URL, then:
curl -X POST https://api.lohevox.cloud/v1/jobs/$JOB_ID/complete \
  -H "Authorization: Bearer $LOHEVOX_API_KEY" \
  -d '{"parts":[{"part_number":1,"etag":"..."}]}'

3. Get the result

{
  "event": "job.completed",
  "job_id": "job_01J...",
  "language": "en",
  "duration_seconds": 3612.4,
  "outputs": ["txt", "srt", "vtt", "json"]
}

Webhooks are signed with HMAC-SHA256 so you can verify they came from us. You can also poll GET /v1/jobs/:id and fetch a short-lived download link from GET /v1/jobs/:id/transcript?format=srt.

JSON output

{
  "language": "en",
  "segments": [
    { "start": 1.20, "end": 5.96,
      "text": "Welcome back to the show.",
      "words": [ { "start": 1.20, "end": 1.62, "word": "Welcome", "p": 0.98 } ] }
  ]
}