Video Task List

Query the current user's video generation tasks from the last 24 hours. This is a frontend-token endpoint and is only available as /api/videos/list; it does not have a /v1 API-key route.

Endpoint

Endpoint	Auth	Purpose
GET /api/videos/list	token: <jwt>	Query the current user's recent video tasks

Admin JWTs may also use Authorization: Bearer <jwt>, but normal frontend JWTs should use the token header.

Query Parameters

Parameter	Type	Required	Description
p	integer	No	Page number, default 1
page_size	integer	No	Items per page; platform default is used when omitted
model	string	No	Filter by model name, for example sora-2
platform	string	No	Filter by task platform, for example openai_azure_video, vertex_video, volcengine_video, or aliyun_video
status	string	No	Filter by task status, for example QUEUED, IN_PROGRESS, SUCCESS, or FAILURE
task_ids	string	No	Comma-separated task IDs

The endpoint always filters to video-generation tasks submitted within the last 24 hours.

Request Examples

cURL

curl "https://api-platform.ope.ai/api/videos/list?p=1&page_size=20&status=SUCCESS" \
  -H "token: $OPEAI_FRONTEND_JWT"

JavaScript

const res = await fetch("https://api-platform.ope.ai/api/videos/list?p=1&page_size=20", {
  headers: {token: process.env.OPEAI_FRONTEND_JWT},
});

console.log(await res.json());

Response Example

{
  "success": true,
  "message": "",
  "data": {
    "list": [
      {
        "id": 123,
        "task_id": "video_690d9b52e2b081908a05ded32cbfc629",
        "created_at": 1762499410,
        "status": "SUCCESS",
        "properties": {
          "input": "Create a short high-definition tech-style video showing AI video generation capabilities.",
          "size": "720x1280"
        },
        "model": "sora-2"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  }
}