Generate Video
This endpoint generates a new video using a Replica and either a script or an audio file.
The only required body parameters are replica_id
and either script
or audio_file
.
The replica_id
is a unique identifier for the Replica that will be used to generate the video. The script
is the text that will be spoken by the Replica in the video. If you would like to generate a video using an audio file instead of a script, you can provide audio_url
instead of script
. Currently, only .wav
files are supported for audio file input.
If a background_url
is provided, Tavus will record a video of the website and use it as the background for the video. If a background_source_url
is provided, where the URL points to a download link such as a presigned S3 URL, Tavus will use the video as the background for the video. If neither are provided, the video will consist of a full screen Replica.
To learn more about generating videos with Replicas, see here.
To learn more about writing an effective script for your video, see Scripting prompting.
Authorizations
Body
A text script that will be used to generate the audio in the video.
A unique identifier for the replica that will be used to generate the video.
A name for the video.
A link to a website. This will be used as the background for the video. The website must be publicly accessible and properly formed.
A direct link to a video that is publicly accessible via a storage location such as an S3 bucket. This will be used as the background for the video. The video must be publicly accessible.
A url that will receive a callback on completion of video generation or on error.
Response
A unique identifier for the video.
The name of the video.
The status of the video. Possible values: queued, generating, ready, deleted, error.
A direct link to view your video once generation has completed, hosted by Tavus.
The date and time the video was created.