- 视频生成（豆包原生）
- 视频生成（OpenAI 兼容）
- 视频内容
- 图像生成（豆包原生）
- 图像生成（OpenAI 兼容）
- 素材库（豆包原生）
- 数据模型
提交视频生成任务（OpenAI Video 别名）
POST
/v1/videos
POST /v1/video/generations 的别名，供遵循 OpenAI Video API 路径约定的客户端使用。请求体与响应体完全一致。
请求参数
Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例：
Authorization: ********************or
Body 参数必填
application/json
示例
{
"model": "doubao-seedance-2-5-260628",
"prompt": "宇航员在月球表面缓缓行走",
"image": "https://example.com/reference-image.jpg",
"seconds": "-1",
"metadata": {
"ratio": "16:9",
"resolution": "480p",
"seed": 42,
"watermark": false,
"camera_fixed": false,
"content": [
{
"type": "text",
"text": "宇航员站起身，回望地球",
"image_url": {
"url": "https://example.com/reference-photo.jpg"
},
"video_url": {
"url": "https://example.com/input-video-clip.mp4"
},
"audio_url": {
"url": "https://example.com/background-music.mp3"
},
"role": "first_frame"
}
],
"return_last_frame": false,
"generate_audio": false,
"draft": false,
"omni_reference_task_type": "reference",
"output_format": "mp4",
"service_tier": "default",
"callback_url": "https://your-server.com/webhook/video-callback"
}
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2-5-260628",
"prompt": "宇航员在月球表面缓缓行走",
"image": "https://example.com/reference-image.jpg",
"seconds": "-1",
"metadata": {
"ratio": "16:9",
"resolution": "480p",
"seed": 42,
"watermark": false,
"camera_fixed": false,
"content": [
{
"type": "text",
"text": "宇航员站起身，回望地球",
"image_url": {
"url": "https://example.com/reference-photo.jpg"
},
"video_url": {
"url": "https://example.com/input-video-clip.mp4"
},
"audio_url": {
"url": "https://example.com/background-music.mp3"
},
"role": "first_frame"
}
],
"return_last_frame": false,
"generate_audio": false,
"draft": false,
"omni_reference_task_type": "reference",
"output_format": "mp4",
"service_tier": "default",
"callback_url": "https://your-server.com/webhook/video-callback"
}
}'返回响应
🟢200
application/json
Bodyapplication/json
示例
{
"id": "task_abc123def456",
"task_id": "task_abc123def456",
"object": "video",
"model": "doubao-seedance-2-0-260128",
"status": "queued",
"progress": 100,
"created_at": 1712345678,
"completed_at": 1712345900,
"expires_at": 1712432300,
"metadata": {
"url": "https://cdn.volcengineapi.com/videos/output-abc123.mp4"
},
"error": {
"code": "content_policy_violation",
"message": "请求内容违反了内容安全策略"
},
"remixed_from_video_id": "task_origin789ghi012"
}🟠400BadRequest
🟠401Unauthorized
🟠402InsufficientQuota
修改于 2026-10-27 14:24:46