Get a job
Returns a job. With wait, holds the request until the job finishes or wait seconds pass.
bearerAuthorizationBearer <API key>An API key from Settings, starting vcp_live_.
id*stringwait?numberSeconds to wait for the job to finish, up to 60.
0 <= value <= 60OK.
application/json- response
id*stringJob id.
type*JobType"speech""voice_design""voice_clone""voice_change""transcription""dub""avatar_video""cut"status*JobStatus"queued""running""succeeded""failed""cancelled"progress*|From 0 to 1 while an avatar video renders, a dub runs or a video is cut, otherwise null.
0 <= value <= 1result*||||||The result of a succeeded job, or null. Speech, voice designs and the voice changer give AudioResult, kept for 24 hours after the job finishes, then this is null. Transcriptions give TranscriptionResult. Voice clones give VoiceCloneResult. Avatar videos give AvatarVideoResult, dubs give DubResult and cuts give CutResult, all kept for 24 hours after the job was created.
error*|Why the job failed, or null.
tokens_charged*|Tokens billed, or null until billing has run.
0 <= valueresource_id*|The voice id for voice clones, the project id for dubs and cuts, and the video id for avatar videos.
created_at*stringWhen the job was created.
date-timefinished_at*|When the job finished, or null while it runs.
date-timecurl -X GET 'https://api.vcp.name/v1/jobs/string'{ "id": "04bd0571-e2c8-4d5b-a3cc-e56f85773abf", "type": "speech", "status": "succeeded", "progress": null, "result": { "audio_url": "https://files.example.com/speech.wav", "download_url": "https://files.example.com/speech.wav?download=speech.wav", "expires_at": "2026-10-31T00:10:42Z" }, "error": null, "tokens_charged": 42, "resource_id": null, "created_at": "2026-10-30T00:10:42Z", "finished_at": "2026-10-30T00:18:01Z"}Cut a video POST
Cuts filler words, retakes and long pauses out of a video of up to 3 hours. Returns a job whose result is a `CutResult`. The job stays `running` until the cut video is ready. Estimated cost: 7000 tokens plus 20 per second of video, plus 4 per second of the cut video.
Cancel a job POST
Cancels a queued or running job. A finished job is returned unchanged.