Jobs API
POST /v1/jobs queues an operation. GET /v1/jobs/{id} checks status, progress, and debited credits.
Queue a Job (POST /v1/jobs)
The request must include an Idempotency-Key header. Replaying the same key with identical input returns the original job without creating duplicates.
operationstringrequiredStudio operation name: 'document.translate', 'document.extract', 'document.transliterate', 'document.summarize', 'audio.transcribe', 'document.narrate', 'audio.dub', or 'music.generate'.
inputobjectrequiredOperation-specific payload containing uploadId and tool parameters.
webhookUrlstringoptionalOptional HTTPS URL to receive an HMAC-signed JSON payload upon job state transitions.
Public Job Object
| Field | Type | Description |
|---|---|---|
| id | string | Unique public UUID for the job |
| operation | string | The operation that was called |
| status | string | queued | running | succeeded | failed |
| createdAt | string | ISO 8601 UTC timestamp |
| errorCode | string | null | Error identifier if the job failed |
| chargedCredits | number | null | Exact number of credits debited upon completion |
| result | object | null | Only on GET /v1/jobs/{id}. null until the job succeeds. See Getting the result below. |
Getting the result
When status is succeeded, GET /v1/jobs/{id} includes a result. For document.translate, document.transliterate and document.extract it is a file: { type: "file", fileName, url, expiresAt }. url is a signed download link valid for one hour; fetch the job again for a fresh link. For document.summarize it is { type: "summary", text, pages }. Audio operations return { type: "files", text, files: [{ role, fileName, url, expiresAt }] }, one entry per output file. GET /v1/jobs (the list) does not include result.
curl -s https://api.transpera.io/v1/jobs/JOB_ID \
-H "Authorization: Bearer tp_live_YOUR_KEY"
# {"job": {"id": "...", "status": "succeeded", "chargedCredits": 90,
# "result": {"type": "file", "fileName": "report_hi.docx",
# "url": "https://storage.googleapis.com/...", "expiresAt": "2026-11-19T14:00:00.000Z"}}}
curl -o translated.docx "SIGNED_URL_FROM_RESULT"