Returns a paginated list of all video generation tasks for the authenticated user.
Query Parameters
Page number for pagination.
Number of videos per page (max 100).
Response
Array of video objects.
Unique identifier for the video.
Current status: pending, processing, completed, or failed.
The original prompt used to generate the video.
The model used for generation.
Unix timestamp of creation.
Examples
List All Videos
import requests
response = requests.get(
"https://api.voidai.app/v1/videos",
headers={"Authorization": "Bearer sk-voidai-your_key_here"},
params={"page": 1, "limit": 10}
)
data = response.json()
for video in data["data"]:
print(f"{video['id']}: {video['status']} - {video['prompt'][:50]}...")
Response Example
{
"data": [
{
"id": "vid_abc123",
"status": "completed",
"prompt": "A serene beach at sunset with gentle waves",
"model": "sora-2",
"created_at": 1701691200
},
{
"id": "vid_def456",
"status": "processing",
"prompt": "A cat playing piano in a jazz club",
"model": "sora-2",
"created_at": 1701691100
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 25
}
}
