๐ Step 1: Generate a List of Video Previews (Async)
Use this endpoint to generate multiple video previews asynchronously before committing to a final render.Endpoint
POST /api/link_to_videos/preview_list_async/Purpose
This allows users to create preivews with multiple visual styles and choose the best one to render.โ ๏ธ Costs 1 credit per 30s per preview.
โ๏ธ Step 2: Get preview generation result
๐ Webhook Callback Example
If you provide awebhook_url
, Creatify will notify your backend of the preview generation result:
๐ Poll API to get Result without Webhook
If you did not provide awebhook_url
, you will have to pool Creatify API to the preview generation result:
โน๏ธ You can embed the preview URLs using <iframe>
tags in your UI to display them.
๐ฎ Step 3: Render One of the Previews
After selecting the best preview, use this endpoint to render the final video from it.Endpoint
POST/api/link_to_videos/{id}/render_single_preview/
Purpose
Commit to rendering a final video using a specific preview.โ ๏ธ Costs 4 credits per 30s.
๐ก Step 4: Get Render result
๐ Webhook Callback Example
If you provide awebhook_url
, Creatify will notify your backend of the render result:
๐ Poll API to get Result without Webhook
If you did not provide awebhook_url
, you will have to pool Creatify API to the render result:
๐ค Tips & Extras
- Use
override_avatar
andoverride_voice
to manually select avatar and voice - Previews let your users pick and compare before rendering
- Preview URLs can be embedded in your product for a seamless experience
- Webhooks let your backend stay in sync with preview/render status