Seedance2.0支持返回官方URL模型文档

baseUrl

BASE_URL = https://apiok.cc

支持的模型

• doubao-seedance-2.0-gf1
• doubao-seedance-2.0-gf1-1080p

创建视频生成任务接口

参数	类型	说明
model	string	调用模型
metadata	object	生成视频条件参数

• metadata 封装的创建视频所需数据

参数	类型	说明
ratio	string	输出比例，默认 16:9。可选值：16:9、9:16、1:1、4:3、3:4、21:9、adaptive。
duration	integer	视频时长，单位秒，默认 5，范围 4-15。
resolution	string	视频分辨率720p, 1080p (根据所选模型选择适当分辨率)
generate_audio	boolean	是否生成音频，默认 true。
content	array	多模态内容数组。必须包含一个 type=text 的提示词。
content[].type	string	内容类型：text、image_url、video_url、audio_url。
content[].role	string	素材角色：first_frame、last_frame、reference_image、reference_video、reference_audio。
content[].image_url.url	string	图片地址。支持公网 URL。如提前上传素材到素材库，也可传素材id，格式： asset://{assetId}
content[].video_url.url	string	视频地址。支持公网 URL。如提前上传素材到素材库，也可传素材id，格式： asset://{assetId}
content[].audio_url.url	string	音频地址。支持公网 URL。如提前上传素材到素材库，也可传素材id，格式： asset://{assetId}

请求示例

curl -X POST "${BASE_URL}/v1/video" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-gf1",
    "metadata": {
        "content": [
            {
                "type": "text",
                "text": "一位穿白裙的女孩在樱花树下转圈起舞，花瓣随风飘落，画面唯美"
            },
            {
                "type": "image_url",
                "image_url": {"url": "https://example.com/girl_portrait.jpg"},
                "role": "reference_image"
            },
            {
                "type": "video_url",
                "video_url": {"url": "https://example.com/cherry_blossom_scene.mp4"},
                "role": "reference_video"
            },
            {
                "type": "audio_url",
                "audio_url": {"url": "https://example.com/dance_pose_ref.mp3"},
                "role": "reference_audio"
            }
        ],
        "duration": 8,
        "resolution": "720p",
        "ratio": "9:16",
        "generate_audio": true
    }
}'

返回示例

{
    "id": "task_id",
    "task_id": "task_id"
}

查询任务状态接口

请求示例

curl -X GET "${BASE_URL}/v1/video/${TASK_ID}" \
  -H "Authorization: Bearer ${API_KEY}"

返回示例

{
    "content": {
        "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02178480289750700000000000000000000ffffac1923a99a3b25.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260723%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260723T103725Z&X-Tos-Expires=86400&X-Tos-Signature=8e6da9ebd46075ecf6de47a46867c773e4ad06c7510b9157146b2221dd726472&X-Tos-SignedHeaders=host"
    },
    "created_at": 1784802897,
    "draft": false,
    "duration": 4,
    "execution_expires_after": 172800,
    "framespersecond": 24,
    "generate_audio": true,
    "id": "task_8kYfWm4MhWAaqd9f5hRkFcRfoBOEg3CQ", 
    "model": "doubao-seedance-2-0-260128",
    "priority": 0,
    "ratio": "9:16",
    "resolution": "720p",
    "seed": 49883,
    "service_tier": "default",
    "status": "succeeded",
    "updated_at": 1784803051,
    "usage": {
        "completion_tokens": 173700,
        "total_tokens": 173700
    }
}

status

• unknown: 刚提交还未进入队列
• queued：排队中。
• running：任务运行中。
• cancelled：取消任务，取消状态24h自动删除（只支持排队中状态的任务被取消）。
• succeeded： 任务成功。
• failed：任务失败。
• expired：任务超时。

⚠️ 注意

如果想要加快视频生成的时间，可以提前调用以下素材创建接口，素材创建成功后(查询素材创建结果的Status为Active)，在视频创建的时候url传入"asset://{assetId}"

创建素材接口

• 请求示例

curl --location 'https://apiok.cc/v1/asset/create' \
--header 'Authorization: Bearer api密钥' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2.0-gf1",
    "assetType": "Image",
    "url": "https://amzn-sub2api.s3.ap-southeast-1.amazonaws.com/newapi/uploads/1785745458553719000.png"
}'

• 响应

{
    "code": "success",
    "message": "",
    "data": {
        "assetId": "asset-20260803172041-kt6gr"
    }
}

• 成功code: "success"
• 失败code: "failed", message: 失败原因

查询素材创建结果

• 请求示例

curl --location 'http://localhost:3301/v1/asset/result' \
--header 'Authorization: Bearer api密钥' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2.0-gf1",
    "assetId": "asset-20260803172041-kt6gr"
}'

• 响应示例

{
    "code": "success",
    "message": "",
    "data": {
        "assetType": "Image",
        "assetId": "asset-20260803172041-kt6gr",
        "Name": "",
        "status": "Active",
    }
}

• 请求成功code: "success"，失败"failed"

• status包含以下状态，仅Active的时候素材才是可用的，其它状态素材均不可用

• Active：已处理完毕，可以使用

• Processing：正在预处理，无法使用

• Failed：处理失败