List all videos

GET/v1/videos

List all video generation tasks for your account.

Authentication

Authorization Bearer

API key as bearer token in Authorization header.

Query Parameters

limitinteger

Maximum number of results to return. Maximum: 100.

afterstring

Cursor for forward pagination.

beforestring

Cursor for backward pagination.

orderenum<string>

Sort direction by created_at.

Response

objectstring

Always list.

dataobject[]

List of video task objects.

data.idstring

Video task ID.

data.objectstring

Always video.

data.statusenum<string>

Task status.

data.modelstring

Model used.

data.promptstring

Input prompt.

data.created_atinteger

Unix timestamp.

data.updated_atinteger

Last-updated Unix timestamp when available.

data.parametersobject

Normalized task parameters.

data.responseobject

Raw response details when available.

data.errorobject

Error details when status=failed.

data.urlstring

Presigned video URL when status=completed.

data.video_urlstring

Video URL when available.

data.usageobject

Usage and billing details when available.

has_moreboolean

Whether more results are available.

first_idstring | null

ID of the first item in data, or null if empty.

last_idstring | null

ID of the last item in data, or null if empty.

Request

Shell
1curl https://api.token360.ai/v1/videos \
2  -H "Authorization: Bearer sk-your-api-key"

Response

JSON
1{
2  "object": "list",
3  "data": [
4    {
5      "id": "your-video-id",
6      "object": "video",
7      "status": "completed",
8      "model": "your-video-model",
9      "prompt": "A cat playing piano...",
10      "created_at": 1701476542,
11      "updated_at": 1701476601,
12      "parameters": {
13        "duration": 4,
14        "resolution": "720p"
15      },
16      "url": "your-video-url",
17      "video_url": "your-video-url"
18    }
19  ],
20  "has_more": false,
21  "first_id": "your-video-id",
22  "last_id": "your-video-id"
23}
Was this page helpful?