Docsdoubao-seedance-2-0-260128

Market/doubao

doubao-seedance-2-0-260128

POST/api/llm/generateTask

请求参数

Headers

Authorizationstringrequired

Bearer token for authentication. Format: 参考市场快速开始Authorization的生成方式

Content-Typestringrequired

Must be application/json

API-KEYstringrequired

API密钥，格式：ak-开头的api-key

Body

modelstringrequired

要使用的模型 ID

contentarrayrequired

输入内容数组，支持 text、image_url、video_url、audio_url 类型

content[].typestringrequired

内容类型：text、image_url、video_url 或 audio_url

content[].textstring

文字描述内容

content[].image_url.urlstring

图片 URL、Base64 或 asset:// 素材 ID；支持 jpeg、png、webp、bmp、tiff、gif

content[].video_url.urlstring

参考视频 URL 或 asset:// 素材 ID；支持 mp4、mov，单段 2~15 秒，最多 3 段

content[].audio_url.urlstring

参考音频 URL、Base64 或 asset:// 素材 ID；支持 wav、mp3，单段 2~15 秒，最多 3 段

content[].rolestring

媒体角色：图片支持 reference_image；视频支持 reference_video；音频支持 reference_audio

toolsarray

工具配置数组，目前支持 web_search

tools[].typestring

工具类型，目前仅支持 web_search

durationinteger

时长（秒），默认 5，支持 [4,15] 或 -1 让模型自动决定时长

ratiostring

宽高比，默认 adaptive；支持 21:9、16:9、4:3、1:1、3:4、9:16、adaptive

resolutionstring

分辨率，默认 720p；支持 480p 或 720p

watermarkboolean

是否添加水印，默认 false

generate_audioboolean

是否生成同步音频，默认 true

Responses

application/json

codeinteger

响应状态码

200: 成功 - 请求已成功处理

401: 未授权 - 缺少身份验证凭据或凭据无效

402: 额度不足 - 账户额度不足，无法执行该操作

404: 未找到 - 请求的资源或接口不存在

422: 校验错误 - 请求参数未通过校验检查

429: 请求受限 - 已超过该资源的请求频率限制

455: 服务不可用 - 系统目前正在维护中

500: 服务器错误 - 处理请求时发生了意外错误

501: 生成失败 - 内容生成任务失败

505: 功能禁用 - 请求的功能目前已禁用

msgstring

响应消息，失败时的错误描述

dataobject

响应数据对象

taskIdstring

任务id

statusstring

任务状态 success 成功 fail 失败 error 错误

videoUrlListarray

视频url列表

imageUrlListarray

图片url列表

audioUrlListarray

音频url列表

usageTotalTokenstring

消耗token总数

textContentstring

文本内容，聊天模型的回复文本

Code Examples

curl -X POST https://overrouter.ai/api/llm/generateTask \
  -H "Content-Type: application/json" \
  -H "Authorization: 参考市场快速开始Authorization的生成方式" \
  -H "API-KEY: 密钥对ak-开头的api-key" \
  -d '{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "Use image 1 for character styling, use video 1 for camera language, and use audio 1 as background music in a cinematic product video."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference-image.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/reference-video.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.com/reference-audio.mp3"
      },
      "role": "reference_audio"
    }
  ],
  "duration": 5,
  "ratio": "adaptive",
  "resolution": "720p",
  "watermark": false,
  "generate_audio": true
}'

200Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "41_tasksmaiid_simengai===da36cc02-d3f2-4cd0-b025-9cdc3fc1c1aa",
    "responseBody": null,
    "usageTotalToken": null,
    "usageTotalPrice": "0",
    "videoUrlList": [
      "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-260128/021775672026273dc81d74c65c8ea02a2c5bb3d59fe0f51831e72_0.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260408%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260408T181352Z&X-Tos-Expires=86400&X-Tos-Signature=ab587ea810f5a8bdc28ad9a8a0a4e30ce2e867eb150510df1ba09f0fd22d0e16&X-Tos-SignedHeaders=host"
    ],
    "imageUrlList": null,
    "textContent": null
  },
  "timestamp": 1778816033566,
  "success": true
}

Back to Docs