Appearance
视频列表
列出当前账号下的视频任务
通过 GET /v1/videos 获取当前账号下的视频任务列表。
bash
curl "https://aiapi.fhddos.com/v1/videos?limit=10&order=desc" \
-H "Authorization: Bearer $TOKEN"查询参数
after:分页游标limit:返回数量上限order:排序方向,例如asc、desc
响应示例
json
{
"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
openapi: 3.0.0
info:
title: OpenAI Video API
description: OpenAI Sora 视频生成 API
version: 1.0.0
servers:
- url: https://aiapi.fhddos.com
description: Fhddos 生产环境
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