Create Task (Volc Compatible)

​

Overview

​

Authentication And Endpoints

• Use Authorization: Bearer <API_KEY>.
• Volc AK/SK signing is not accepted in this version. Requests with only AK/SK signing return a Volc-style authentication error.
• Version may be omitted. If provided, it must be 2024-01-01.

​

Content Rules

• type: "text" is the prompt text.
• type: "image_url" without role, or with role: "first_frame", is treated as the first frame.
• role: "last_frame" must be paired with a first frame.
• role: "reference_image", reference_video, and reference_audio are used as references.
• image_url.url accepts a public image URL or a material URI such as asset://asset-YYYYMMDDHHMMSS-xxxxx. The role determines whether that material is a first frame, last frame, or reference image.
• As a compatibility shorthand, one top-level material_asset_id is treated as the first frame. Multiple top-level material_asset_ids are rejected because their roles are ambiguous; put them in content[] with explicit roles instead.
• Do not mix first/last frame inputs with reference media in one request.

​

Parameter Notes

• ratio accepts 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, or adaptive.
• duration is the video length in seconds, including model-supported automatic duration values.
• resolution accepts 480p, 720p, 1080p, or 4k when supported by the selected Seedance model.
• generate_audio defaults to true; set it to false for a silent video.
• watermark, return_last_frame, seed, priority, execution_expires_after, and safety_identifier are accepted when valid for the selected model.
• callback_url is not supported yet. Poll task status instead.

​

Image Preparation

​

Create Response

{
  "id": "cgt-0123456789abcdef0123456789abcdef"
}

​

Example

​

REST Create

curl https://api.aisonar.dev/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {"type": "text", "text": "A cinematic forest at sunset"},
      {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/ref.png"}}
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "generate_audio": true
  }'

{
  "material_asset_id": "asset-20260720123456-qn7wr"
}

[
  {
    "type": "image_url",
    "role": "first_frame",
    "image_url": {"url": "asset://asset-20260720123458-start"}
  },
  {
    "type": "image_url",
    "role": "last_frame",
    "image_url": {"url": "asset://asset-20260720123459-end01"}
  }
]

​

Action Create

curl "https://api.aisonar.dev/api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [{"type": "text", "text": "A clean product reveal video"}],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p"
  }'

​

Next Step