> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hingnet.com.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 视频列表

> 列出当前账号下的视频任务

通过 `GET /v1/videos` 获取当前账号下的视频任务列表。

```bash theme={null}
curl "https://models.hingnet.com.cn/v1/videos?limit=10&order=desc" \
  -H "Authorization: Bearer $TOKEN"
```

## 查询参数

* `after`：分页游标
* `limit`：返回数量上限
* `order`：排序方向，例如 `asc`、`desc`

## 响应示例

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737",
      "object": "video",
      "created_at": 1762789802,
      "status": "success",
      "model": "sora-2",
      "prompt": "百事可乐宣传片",
      "progress": 100,
      "seconds": "8",
      "size": "720x1280"
    }
  ]
}
```


## OpenAPI

````yaml GET /v1/videos
openapi: 3.0.0
info:
  title: OpenAI Video API
  description: OpenAI Sora 视频生成 API
  version: 1.0.0
servers:
  - url: https://models.hingnet.com.cn
    description: HingNet 生产环境
security:
  - BearerAuth: []
paths:
  /v1/videos:
    get:
      tags:
        - Videos
      summary: 列出视频任务
      description: 列出当前账号下的视频任务
      operationId: listVideos
      parameters:
        - name: after
          in: query
          required: false
          description: 分页游标
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: 返回数量上限
          schema:
            type: integer
            minimum: 1
        - name: order
          in: query
          required: false
          description: 排序方向
          schema:
            type: string
            example: desc
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoListObject'
              example:
                object: list
                data:
                  - id: video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737
                    object: video
                    created_at: 1762789802
                    status: success
                    model: sora-2
                    prompt: 百事可乐宣传片
                    progress: 100
                    seconds: '8'
                    size: 720x1280
components:
  schemas:
    VideoListObject:
      type: object
      properties:
        object:
          type: string
          example: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/VideoObject'
    VideoObject:
      type: object
      properties:
        id:
          type: string
          description: 视频任务的唯一标识符
          example: video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737
        object:
          type: string
          description: 对象类型
          enum:
            - video
          example: video
        created_at:
          type: integer
          description: 创建时间戳（Unix 时间）
          example: 1762789802
        completed_at:
          type: integer
          description: 任务完成时间戳（仅在 success 状态下存在）
          example: 1762789891
        expires_at:
          type: integer
          description: 视频过期时间戳（仅在 success 状态下存在）
          example: 1762793491
        model:
          type: string
          description: 使用的模型名称
          example: sora-2
        status:
          type: string
          description: 任务状态
          enum:
            - queued
            - processing
            - success
            - failed
          example: queued
        prompt:
          type: string
          description: 生成视频的文本描述
          example: 一个无人机从海滩升空拍摄夕阳
        progress:
          type: integer
          description: 处理进度（0-100）
          minimum: 0
          maximum: 100
          example: 0
        seconds:
          type: string
          description: 视频时长（字符串格式）
          example: '8'
        size:
          type: string
          description: 视频分辨率
          example: 720x1280
        assets:
          type: array
          description: 生成的视频资源数组，仅在 success 状态下存在（部分供应商可能不返回此字段，需通过 /content 端点下载）
          items:
            $ref: '#/components/schemas/VideoAsset'
        remixed_from_video_id:
          type: string
          description: Remix 来源视频 ID（仅 Remix 任务返回）
          example: video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737
        error:
          type: object
          description: 错误信息，仅在 failed 状态下存在
          properties:
            code:
              type: string
              example: generation_failed
            message:
              type: string
              example: 视频生成失败，请重试
    VideoAsset:
      type: object
      properties:
        url:
          type: string
          description: 视频文件 URL
          example: >-
            https://cdn.example.com/video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737.mp4
        quality:
          type: string
          description: 视频质量/分辨率
          example: 1280x720
        duration:
          type: integer
          description: 视频时长（秒）
          example: 8
        size_bytes:
          type: integer
          description: 文件大小（字节）
          example: 5242880
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 使用 API Key 作为 Bearer Token

````