videos

A video is finished

POSTed to the request's callback_url once the video is completed, failed or cancelled: the video as get_video returns it. Kinetune-Signature is t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<body>"> with your callback secret. Answer with any 2xx within 10 seconds; anything else is retried after 30 s, 2 min, 10 min, 30 min and 2 h.

postWebhookvideo

Headers

Kinetune-Event'video.completed' | 'video.failed' | 'video.cancelled' required
Kinetune-Deliverystring uuid required

A new id for every attempt

Kinetune-Signaturestring required

Payload

idstring required
type'lyric-video' | 'canvas' required
variationinteger required
variation_countinteger required
quote_idstring nullable required
status'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' required
stagestring required

The step it is at while it is made

progressnumber required

0–100

requestobject required

What the video was made from, with your metadata

look_idstring nullable required
lookobject nullable required
canvasobject nullable

A Canvas: its design and, for stock, the credit to show

quoted_creditsnumber nullable required
charged_creditsnumber nullable required
errorstring nullable required
error_codestring nullable required
retry_of_job_idstring nullable required
created_atstring required
updated_atstring required

Response

Received

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.