Endpoints

Base URL

https://dublab.app/api/v2

All endpoints use the apikey header (or Authorization: Bearer) and snake_case fields. See Authentication for keys.

Endpoint Summary

Workflow

POST /dubs (file or source_url)  →  poll GET /dubs/{id}  →  read `outputs`

1. Create: POST /api/v2/dubs with a file upload or a source_url.
2. Poll: GET /api/v2/dubs/{id} until external_status_id = 5 (Completed).
3. Download: read the outputs map on the dub — signed URLs are included directly on the List and Dub Details responses (no separate call).

Status Codes (external_status_id)

The public status surface is 1–5 (the pipeline tracks a separate internal status not returned by the API).

Output types

outputs is a map of { <type>: { url, download_url } }. url is inline-viewable, download_url forces a file download. Both are presigned and expire ~1 hour after the response. The map is empty until the dub completes.

Error Handling

All errors return { "error": "message" } with an appropriate HTTP status code:

Notes

• Billing: credits are charged once on completion, against the server-measured output duration (measured_duration), not the duration you submit.
• Multiple target languages = multiple POST /dubs calls (one per dest_lang).