查询视频任务
查询 OpenAI 兼容 /v1/videos 任务状态与结果。
Authorization
bearerAuth 使用 Authorization Bearer API Key 进行鉴权。
In: header
Path Parameters
视频生成任务 ID。
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/videos/task_123456"{
"id": "task_123456",
"task_id": "task_123456",
"object": "video",
"status": "completed",
"model": "string",
"created_at": 0,
"updated_at": 0,
"completed_at": 0,
"expires_at": 0,
"seconds": "string",
"size": "string",
"progress": 0,
"url": "http://example.com",
"video_url": "http://example.com",
"content_url": "http://example.com",
"remixed_from_video_id": "string",
"output": [
{}
],
"metadata": {
"url": "string",
"usage": {
"completion_tokens": 0,
"total_tokens": 0,
"tool_usage": {
"web_search": 0
}
},
"last_frame_url": "http://example.com",
"output_format": "string",
"duration": 0,
"duration_seconds": 0,
"resolution": "string",
"ratio": "string",
"seed": 0,
"generate_audio": true
},
"error": {}
}{
"error": {
"code": "string",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"request_id": "string"
}
}Video Generation
通过 OpenAI 兼容的 `/v1/videos` 接口创建视频生成任务,适用于 PixVerse、Veo、Seedance、Wan 3.0 等兼容提供商。 Grok 视频生成也使用该接口,模型可选 `grok-imagine-video` 或 `grok-imagine-video-1.5-preview`。Grok 请求使用 `application/json`,可通过 `reference_images` 传参考图片 URL,并通过 `video.url` 传参考视频 URL。 Wan 3.0 可使用与 `/v1/video/generations` 相同的通用请求字段。需要完整原生媒体和参数时,通过 `metadata.input.media` 和 `metadata.parameters` 传入。 Seedance 2.0 / 2.5 素材支持自动上传:在图片、视频或音频素材字段中直接传入公网可访问的 `https://` 链接,系统会自动识别并上传素材,无需提前调用 `/api/assets/upload`。 Seedance 2.5 任务类型放在顶层 `omni_reference_task_type`,兼容 `metadata.omni_reference_task_type`(顶层优先);`metadata.content` 非空时完整替换快捷媒体映射。编辑使用 `duration: -1` 和 `metadata.ratio: adaptive`;延长也要求 `metadata.ratio: adaptive`。`seconds` 与 `duration` 不要传冲突值。Seedance 的 `watermark`、`return_last_frame`、`seed`、`camera_fixed`、`draft`、`service_tier`、`execution_expires_after`、`priority`、`safety_identifier`、`callback_url`、`output_format`、`tools`、`frames` 放在 `metadata` 下;所有内置 Seedance 路径保留显式 false/0,多视频和多音频数组不会截为第一项。
Download Video Content
下载已生成的视频内容,适用于提供 content 端点的视频模型。