Seedance：影片生成 API

"content": [
  { "type": "text", "text": "橘貓在草地上奔跑，鏡頭跟隨" },
  { "type": "image_url", "image_url": { "url": "https://example.com/cat.png" }, "role": "reference_image" },
  { "type": "video_url", "video_url": { "url": "https://example.com/ref.mp4" } },  // role 省略時為 reference_video
  { "type": "audio_url", "audio_url": { "url": "https://example.com/ref.mp3" } }   // role 省略時為 reference_audio
]

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "pending",
    "outputs": [],
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": null
  }
}

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "processing",
    "outputs": [],
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": null
  }
}

{
  "task": {
    "id": "vtEXAMPLE",                       // HopBase 任務 ID
    "model": "dreamina-seedance-2-5-260628",
    "status": "completed",
    "duration_seconds": 5,                   // 自動時長任務請在完成後讀取
    "outputs": ["https://api.hop-base.com/example-signed-video.mp4"],  // 字串陣列，不是 {url} 物件
    "last_frame_url": "https://api.hop-base.com/example-signed-last-frame.jpg",  // 可選，取得末幀時才有
    "usage": { "completion_tokens": 1000, "total_tokens": 1000 },  // 可選；是 tokens，不是金額
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": "2026-09-23T08:03:10Z"   // 未完成時為 null
  },
  "usage": { "cost": 3.4, "currency": "CNY", "cost_cny": 3.4, "cost_usd": 0.5 }
}

{
  "task": {
    "id": "vtEXAMPLE",
    "status": "failed",
    "outputs": [],
    "error": { "message": "<English failure reason>" }
  }
}

# 類型與取值
duration must be an integer                    # priority / execution_expires_after 同理
watermark must be a boolean                    # generate_audio / return_last_frame 同理
Seedance 2.0 duration must be an integer in 4-15 or -1, got 20
Seedance 2.5 duration must be an integer in 4-30 or -1, got 40
model dreamina-seedance-2-0-hc does not support parameter seed   # 被拒欄位；報錯裡是你請求的模型 ID
model dreamina-seedance-2-0-hc does not support ratio 2:1
model dreamina-seedance-2-0-fast-hc does not support resolution 1080p
request body must not exceed 64MB
priority must be within 0-9, got 10
execution_expires_after must be within 3600-259200 seconds
callback_url must be a valid http(s) URL
safety_identifier must be an ASCII string of 1-64 characters

# content 結構
missing content                                # 只傳了頂層 prompt
content[0].image_url must be an object         # image_url 寫成了字串
content[0].type does not support image         # type 寫成 image / input_image
content[0].text must not be empty
multi-image scenarios must specify first_frame/last_frame or reference_image roles
images in a multimodal reference scenario must set role=reference_image
first/last frame image-to-video cannot be mixed with the multimodal reference scenario
Seedance 2.0 supports at most 9 reference images

# 模型與分組
domestic doubao-seedance-2-0-fast-260128-a only supports 480p, 720p, got 1080p
model seedream-5-0-pro is an image generation model, use POST /v1/images/generations instead

content[1] media URL returned HTTP 403        # 素材位址拒絕下載（防盜鏈、簽名過期等）
content[1] unable to fetch media file, make sure the URL is publicly accessible
content[1] media URL hostname could not be resolved
content[1] media URL must point to a public address, not a private or reserved one
content[1] too many redirects for media URL
content[1] unable to parse media metadata of the video asset   # 文件損壞或格式不符
content[1] media data URL must be base64-encoded
content[1] image data URL does not support MIME type image/svg+xml
    # 允許：image/jpeg png webp bmp tiff gif heic heif；audio/wav audio/mpeg
content[1] reference image width and height must be within 300-6000 px, got 200x200
content[1] video asset duration must be within 2-15 seconds, got 16.000 seconds
total reference video duration must not exceed 15 seconds, got 18.000 seconds

media validation timed out, please retry later

content[1] reference asset is not ready yet, current status is Processing  # 繼續查詢素材，Active 後再提交
content[1] requires a image asset, got Video       # AssetType 與 image_url / video_url / audio_url 不對應
content[1] references a retired Seedance 2.5 EP asset; ...  # asset25-* 已退役，改傳原始公網 URL
... cannot be mixed in one task                    # 只引用同一批上傳的素材，或改為直接傳公網 URL

OutputVideoSensitiveContentDetected / OutputAudioSensitiveContentDetected  # 成片未通過審核；帶 PolicyViolation 為版權
rejected by content moderation                                             # 成片、提示詞或參考素材未通過內容審核
InputImageSensitiveContentDetected 等 Input…Sensitive…                      # 輸入素材未通過審核，含真人隱私
InvalidParameter / is not valid / missing required / identified your task as  # 參數或任務模式不合法
task no longer exists                                                        # 任務不存在或已被清理
task expired / timed out / did not finish within 24 hours                     # 任務逾時或已過期