1. Video (Doubao native)
Ark-Docs
  • Video (Doubao native)
    • Submit a video generation task (Doubao native)
      POST
    • Retrieve a video generation task (Doubao native)
      GET
  • Video (OpenAI compatible)
    • Submit a video generation task (OpenAI compatible)
      POST
    • Retrieve a video generation task
      GET
    • Submit a video generation task (OpenAI Video alias)
      POST
    • Retrieve a video generation task (OpenAI Video alias)
      GET
  • Video content
    • Download the generated video file
      GET
  • Image (Doubao native)
    • Generate an image (Doubao native)
      POST
  • Image (OpenAI compatible)
    • Generate an image (OpenAI compatible)
      POST
    • Edit an image (OpenAI compatible)
      POST
  • Asset library (Doubao native)
    • Manage the asset library (Doubao native)
      POST
  • 数据模型
    • VideoGenerationRequest
    • VideoFormDataRequest
    • VideoMetadata
    • DoubaoNativeVideoRequest
    • DoubaoNativeContentItem
    • VideoTaskResponse
    • DoubaoNativeVideoResponse
    • VideoTaskError
    • DoubaoImageRequest
    • ImageEditFormDataRequest
    • DoubaoImageResponse
    • ErrorResponse
    • DoubaoAssetRequest
    • DoubaoAssetResponse
  1. Video (Doubao native)

Submit a video generation task (Doubao native)

POST
/doubao/api/v3/contents/generations/tasks
Submit an asynchronous video generation task in Volcengine Ark format.
The response returns immediately with a task ID. Poll
GET /doubao/api/v3/contents/generations/tasks/{task_id} for the result.
Request shape
content is a top-level array, not nested under metadata.
prompt may be sent at the top level or as a text item inside content.
Duration uses duration as an integer (for example 5 or -1).
Other parameters (ratio, resolution, watermark, ...) are top-level.
Supported scenarios
Scenariocontent items
Text to videotext
Image to video, first frametext + image_url with role: first_frame
Image to video, first and last frametext + two image_url with role: first_frame and role: last_frame
Multimodal referencetext + any mix of image_url, video_url, audio_url
Edit videotext that refers to @video 1 + video_url, plus omni_reference_task_type: edit
Extend videotext that refers to @video 1 + video_url, plus omni_reference_task_type: extend
Media references
Every reference is an HTTP(S) URL or a Base64 data URI, for example
data:image/png;base64,.... The format tag must be lowercase.
When image hosting is configured for the channel, the gateway uploads
inline Base64 to the image host and forwards the resulting URL, so Base64
references also go through real-person verification. Without image hosting
the value is forwarded unchanged. A channel can override this in its
settings (follow the global scope, always convert, or never convert) —
choose never convert when the image host is unreachable from upstream.
Choosing a route
Use POST /v1/video/generations when you want the OpenAI-compatible request
shape instead.

请求参数

Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例：
Authorization: ********************
or
Body 参数application/json必填

示例
{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "An astronaut walks slowly across the lunar surface, Earth hanging in a black sky"
        }
    ],
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/doubao/api/v3/contents/generations/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "An astronaut walks slowly across the lunar surface, Earth hanging in a black sky"
        }
    ],
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}'

返回响应

🟢200
application/json
Task accepted. The task is queued and status is pending.
Bodyapplication/json

示例
{
    "id": "cgt-20260414114820-abcde",
    "model": "doubao-seedance-2-0-260128",
    "status": "pending",
    "created_at": 1712345678
}
🟠400BadRequest
🟠401Unauthorized
🟠402InsufficientQuota
🟠429RateLimited
修改于 2026-11-02 11:42:38
下一页
Retrieve a video generation task (Doubao native)
Built with