Retrieve Video

1. Overview

Use this API to retrieve the task status.

Before making the request, you must first call the video generation API to obtain the video_id, and then append it to the URL as a parameter.

2. Request Description

• Request method: GET

• Request address: https://gateway.theturbo.ai/v1/videos/{video_id}

3. Input Parameters

3.1 Header Parameters

Parameter Name	Type	Required	Description	Example Value
Authorization	string	Yes	API_KEY required for authentication. Format: Bearer $YOUR_API_KEY	Bearer $YOUR_API_KEY

4. Request Example

curl https://gateway.theturbo.ai/v1/videos/video_68f742df11b8819094cfb7c08788ed02 \
	-H "Authorization: Bearer $YOUR_API_KEY"

5. Response Example

{
	"id": "video_68f742df11b8819094cfb7c08788ed02",
	"object": "video",
	"created_at": 1761035293,
	"status": "completed",
	"completed_at": 1761035357,
	"error": null,
	"expires_at": 1761121693,
	"model": "sora-2",
	"progress": 100,
	"remixed_from_video_id": null,
	"seconds": "4",
	"size": "1280x720"
}