Create Doubao Video Task

Dedicated route: POST https://maasunion.com/doubao/v1/video/generations · GET https://maasunion.com/doubao/v1/video/generations/{task_id}
Compatible route: POST https://maasunion.com/v1/video/generations · GET https://maasunion.com/v1/video/generations/{task_id}
Upstream capability: Volcano Engine Ark Seedance video generation (/api/v3/contents/generations/tasks)
Official reference:

• Create Video Generation Task API
• Query Video Generation Task API

Overview

Doubao Video is the gateway's dedicated interface for the Seedance model family on Volcano Engine Ark, used for asynchronous video generation, including:

• Text-to-Video, Image-to-Video (first frame / first & last frame)
• Multimodal reference video generation (Seedance 2.0: reference image 0–9 + reference video 0–3 + reference audio 0–3 + text)
• Audio / silent video (generate_audio)
• Draft mode (Seedance 1.5 pro, draft: true)
• Video editing / extension (Seedance 2.0 multimodal reference)

Video generation is asynchronous: the create endpoint returns a task ID; you need to poll the query endpoint for the final video URL, available from content.video_url.

Dedicated Route

Supported Models (Built-in Reference)

Model Capability Matrix

Authentication

Clients do not need to (and should not) pass the upstream key.

Interface Description

1. Create Video Generation Task

POST https://maasunion.com/doubao/v1/video/generations

Asynchronous interface: returns the gateway task ID immediately; poll the query endpoint for the final video URL.

2. Query Video Generation Task

GET https://maasunion.com/doubao/v1/video/generations/{task_id}

task_id is the id returned by the gateway when creating the task (format like task_xxxxxxxx).

Only task records from the last 7 days can be queried. The generated video_url is valid for 24 hours; please download or persist it in time.

Request Parameters

Request Body

Choose either duration or frames; frames has higher priority.
The parameters above can also be passed via the compatible route inside metadata; see Compatibility Mode.
Parameters support two input methods: new method (recommended) passed directly in the request body (strict validation); legacy method appended after the text prompt as --[parameters] (weak validation).

content Object

content supports the following combinations:

• Text
• Text (optional) + image
• Text (optional) + video
• Text (optional) + image + audio
• Text (optional) + image + video
• Text (optional) + video + audio
• Text (optional) + image + video + audio
• Draft task ID (1.5 pro only)

Text

Image

Video (Seedance 2.0 only)

Reference video requirements:

Supported container/encoding formats:

Audio (Seedance 2.0 only)

Note: Audio cannot be sent alone; include at least 1 reference video or image. At most 3 reference audio clips.

Draft Task (1.5 pro only)

Resolution and Aspect Ratio Reference

The following output pixel dimensions are for reference for each resolution + ratio combination (different model series may differ slightly):

480p

720p

1080p (Seedance 2.0 fast does not support)

Create Task Response

After successful creation, the gateway passes through the upstream Volcano Engine Ark Seedance create-task response as-is, only replacing id with the gateway public task ID (used for subsequent queries).

Response example:

{
  "id": "task_20260409120000_abc123"
}

Call Examples

1. Text-to-Video

curl -X POST "https://maasunion.com/doubao/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "content": [
      {
        "type": "text",
        "text": "Realistic style, under a clear blue sky, a vast field of white daisies, the camera slowly zooms in and finally focuses on a close-up of a daisy, with crystal dewdrops on the petals"
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'

2. Image-to-Video (First Frame, with Audio)

curl -X POST "https://maasunion.com/doubao/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "text",
        "text": "A girl hugging a fox; the girl opens her eyes and looks at the camera tenderly, the fox hugs her back, the camera slowly pulls out, the girl’s hair is blown by the wind, and you can hear the wind"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/fox-girl.png"
        }
      }
    ],
    "generate_audio": true,
    "ratio": "adaptive",
    "duration": 5,
    "watermark": false
  }'

3. Image-to-Video (First & Last Frame)

curl -X POST "https://maasunion.com/doubao/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "text",
        "text": "The girl in the picture says \"cheese\" to the camera, with a 360-degree orbiting camera"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/first.jpeg" },
        "role": "first_frame"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/last.jpeg" },
        "role": "last_frame"
      }
    ],
    "generate_audio": true,
    "ratio": "adaptive",
    "duration": 5,
    "watermark": false
  }'

4. Image-to-Video (Base64 Image)

curl -X POST "https://maasunion.com/doubao/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-i2v-250428",
    "content": [
      {
        "type": "text",
        "text": "A girl hugging a fox, the camera slowly pulls out, the girl’s hair blown by the wind"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
        }
      }
    ],
    "ratio": "adaptive",
    "duration": 5,
    "watermark": false
  }'

5. Seedance 2.0 - Multimodal Reference Video

curl -X POST "https://maasunion.com/doubao/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "Use the first-person perspective of video 1 throughout, and use audio 1 as the background music throughout. A first-person perspective fruit tea commercial"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/ref1.jpg" },
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/ref2.jpg" },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://example.com/ref1.mp4" },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": { "url": "https://example.com/bgm.mp3" },
        "role": "reference_audio"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "watermark": true
  }'

Compatibility Mode

In addition to the dedicated route, the gateway also supports calling the same Seedance capability through the OpenAI video-compatible format:

Compatible Request Format

{
  "model": "doubao-seedance-1-5-pro-251215",
  "prompt": "A girl hugging a fox, the camera slowly pulls out",
  "images": ["https://example.com/frame.png"],
  "seconds": "5",
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/frame.png" },
        "role": "first_frame"
      }
    ],
    "ratio": "16:9",
    "generate_audio": true,
    "resolution": "720p",
    "watermark": false
  }
}

Notes:

• prompt is converted to a text entry in content
• images array is converted to image_url entries
• seconds / duration is mapped to the upstream duration
• Seedance-specific fields in metadata (e.g. content, ratio, generate_audio) are merged into the upstream request

Recommendation: For new integrations, prefer the native format at /doubao/v1/video/generations; parameters match the official docs and the behavior is predictable.

Billing

The gateway bills based on the usage returned by the upstream and the task configuration:

The actual deduction rules depend on the configured model price / multiplier.

The response header X-New-Api-Other-Ratios may contain the additional multiplier info for this request (e.g. video_input).

Notes

1. Asynchronous task: The create endpoint only returns the task ID; you must poll the query task endpoint to get video_url.
2. Video URL validity: Valid for 24 hours after generation; please download or persist in time (TOS data subscription auto-persistence can be configured).
3. Task record retention: Upstream task records are only kept for 7 days (from created_at). Query time range is [T-7 days, T).
4. model and content are required: The dedicated route does not auto-fill placeholder content; content must contain at least one valid input.
5. Seedance 2.0 account requirement: Activating 2.0 / 2.0 fast requires account balance ≥ 200 CNY or a purchased resource pack (subject to the Volcano Engine Ark console).
6. Face material restriction: Seedance 2.0 does not support directly uploading reference images/videos containing real human faces; you can use preset virtual portraits, authorized materials, or partial model outputs containing faces as input.
7. Audio input restriction: Audio cannot be sent alone; it must include at least 1 reference video or image.
8. Parameter compatibility: Different models may support different parameters and values; when the input does not match the selected model, the parameter will be ignored or trigger an error.
9. duration and frames: Only one of them will be returned in the response; frames is returned when specified, otherwise duration.

Document updated: 2026-06-16