Learn how to use our API endpoints to create replicas.
Follow this guide to successfully create and retrieve a replica using our API endpoints. Before continuing, ensure that you have recorded training footage by following the instructions in our Training Guide. Verify that:
You cannot send us API requests without a valid key. If your organization does not have an API key, read Getting an API Key to set this up.
In order for us to access your training footage, you need to upload it onto S3 and provide us with a public download link (e.g. pre-signed S3 url). Make sure that your url is valid for at least 24 hours.
You are now ready to submit your footage for training! Reference our Create Replica API Reference to build out your request body. Once ready, include your API Key as a header and fire off your request to our endpoint.
By default, all new replicas will be trained using the phoenix-3
model. You can optionally create phoenix-2 replicas by setting the model_name
parameter to phoenix-2
in the request body.
If successful, you should receive this response from Tavus:
Upon submission, your replica will immediately start training in the background. After 4-6 hours, your replica will be ready for use. You will recieve an update through your callback URL or through our Get Replica endpoint.
The Callback URL in your Create Replica request body will receive a callback when your replica is done training. Errors in training will also be communicated through callbacks on the same URL. Learn more about API callbacks here.
You can also poll our Get Replica endpoint to get real-time updates on your replica’s status. Include the replica_id
as a parameter.
If successful, you should get a response from us with information about your replica. Refer to "status"
to check your replica’s training progress.
At this point, you should have recieved your replica! Now you can try generating videos or starting conversations, either through our API endpoints or on the Developer Portal.
If you are struggling with this process or are unhappy about your replica, be sure to refer to API Errors and Status Details or reach out to our team. We are dedicated to giving you the best replica possible 🚀
Learn how to use our API endpoints to create replicas.
Follow this guide to successfully create and retrieve a replica using our API endpoints. Before continuing, ensure that you have recorded training footage by following the instructions in our Training Guide. Verify that:
You cannot send us API requests without a valid key. If your organization does not have an API key, read Getting an API Key to set this up.
In order for us to access your training footage, you need to upload it onto S3 and provide us with a public download link (e.g. pre-signed S3 url). Make sure that your url is valid for at least 24 hours.
You are now ready to submit your footage for training! Reference our Create Replica API Reference to build out your request body. Once ready, include your API Key as a header and fire off your request to our endpoint.
By default, all new replicas will be trained using the phoenix-3
model. You can optionally create phoenix-2 replicas by setting the model_name
parameter to phoenix-2
in the request body.
If successful, you should receive this response from Tavus:
Upon submission, your replica will immediately start training in the background. After 4-6 hours, your replica will be ready for use. You will recieve an update through your callback URL or through our Get Replica endpoint.
The Callback URL in your Create Replica request body will receive a callback when your replica is done training. Errors in training will also be communicated through callbacks on the same URL. Learn more about API callbacks here.
You can also poll our Get Replica endpoint to get real-time updates on your replica’s status. Include the replica_id
as a parameter.
If successful, you should get a response from us with information about your replica. Refer to "status"
to check your replica’s training progress.
At this point, you should have recieved your replica! Now you can try generating videos or starting conversations, either through our API endpoints or on the Developer Portal.
If you are struggling with this process or are unhappy about your replica, be sure to refer to API Errors and Status Details or reach out to our team. We are dedicated to giving you the best replica possible 🚀