Generate a list of Previews Async
This endpoint generates a list of preview videos asynchronously before rendering the final video. This endpoint costs 1 credit for every 30 seconds.
About previews Field in the Response
The previews field provides a list of urls to preview videos. This url allows you to preview the video before rendering it, you can put it in an iframe to show the video in your application. Example: The previews field in the response will look like this:
About Request Data Structure of Webhook
If the ‘webhook_url’ is passed in the parameters, we will initiate a POST request to the webhook_url
when the previews generation succeeds or fails, with the following content:
Arguments:
id
(string): The unique identifier of the jobstatus
(string): The status of the job. Possible values arepending
,in_queue
,running
,failed
,done
failed_reason
(string): The reason of the failure if the job failedpreviews
(list[dict]): The URL of the video if the job is done
Note: We might send multiple requests for status changes.
About override_avatar parameter
When using ‘create video from link’ API, if the ‘override_avatar’ (avatar_id
is passed in the parameters, we will use it as the avatar of the video. If the ‘override_avatar’ is not passed, we will use the matched avatar for the video.
avatar_id
is the unique identifier of an avatar. You can get the avatar_id
by calling the Get avatar endpoint.
About override_voice parameter
When using ‘create video from link’ API, if the ‘override_voice’ is passed in the parameters, we will use it for the voiceover of the video. If the ‘override_voice’ is not passed, we’ll use the matched voice (from the avatar) for the video.
voice_id
is the unique identifier of the voice. You can get the voice_id by calling the Get voices interface.
Tips: foreach voice has multiple accents, you can choose one from the accents as the voice of the video.
Authorizations
API ID, from your settings page.
API Key, from your settings page.
Body
Response
The response is of type object
.