Optional text prompt steering the thumbnail composition.
jobTypestring
Required
The type of generative job to create. Currently the only published value is `thumbnail`.
sourceUristring
Required
URL of the source video to extract thumbnails from.
maskImageUristring
Optional mask image URL for inpainting.
referenceImageUristring
Optional reference image URL. The thumbnail composition draws stylistic cues from this image. Upload via `POST /api/upload-links` with `usecase: 'FreeToolMedia'`, then pass the returned `cdnUrl` here.
Observable output
jobIdstring
Required
The generated job ID. Use it with `GET /api/generative-jobs/{jobId}` to poll status and fetch results.
Reviewed examples
Create a generative job such as thumbnail generation.