OpenAI 兼容视频生成
通过 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,多视频和多音频数组不会截为第一项。
Authorization
bearerAuth 使用 Authorization Bearer API Key 进行鉴权。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/videos" \ -H "Content-Type: application/json" \ -d '{ "model": "doubao-seedance-2-0-260128", "prompt": "生成一段苹果果茶广告。", "duration": 15, "size": "720p", "metadata": { "ratio": "16:9", "watermark": true, "return_last_frame": true, "generate_audio": false, "priority": 0 } }'{
"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"
}
}