get https://api.heygen.com/v2/video_translate/
Response
| Field | Type | Description |
|---|---|---|
| video_translate_id | str | ID of the video. |
| title | str | Title of the video. |
| status | str | Video status, one of - running (The video is rendering)- success (The video render success)- failed (An error occurred when rendering video)- pending (The video rendering waiting in queue) |
| url | str | The URL of the video after completed. The URL will be expired in seven days. |
| message | str | Optional, the error detail of the video. |
{
"error": null,
"data": {
"video_translate_id": "<video_translate_id>",
"title": "New Video",
"status": "success",
"url": "<url>",
"message": null
}
}
{
"error": null,
"data": {
"video_translate_id": "<video_translate_id>",
"title": "New Video",
"status": "failed",
"url": null,
"message": "<message>"
}
}
{
"error": null,
"data": {
"video_translate_id": "<video_translate_id>",
"title": "New Video",
"status": "pending",
"url": null,
"message": null
}
}
{
"error": null,
"data": {
"video_translate_id": "<video_translate_id>",
"title": "New Video",
"status": "running",
"url": null,
"message": null
}
}
The video file URL you get will expire in 7 days. 📆
You can observe this expiration in the URL parameters. Every time you call the video status endpoint, the
Expiresand other queries are regenerated accordingly.