创建视频任务

正式环境

https://api.naoshengyun.com

POST

/v1/video/tasks

创建异步视频生成任务，成功后返回任务 ID。
当前支持 seedance-2.0、seedance-2.0-fast、seedance-2.0-mini 和 seedance-2.5。公共输入支持 HTTP(S) URL，素材输入使用 asset://<素材ID>。
模型差异：

seedance-2.0 系列：duration 为 -1 或 4～15；参考图片/视频/音频最多 9/3/3。

seedance-2.5：duration 为 -1 或 4～30；参考图片/视频/音频最多 30/10/10。

Seedance 2.5 样片模式：

Draft：必须显式传 draft: true 和 resolution: "480p"，其余内容按普通请求规则填写。

Final：content 必须且只能包含一个 draft_task，必须显式传 resolution: "1080p"。不接受额外 content、draft、ratio、duration 或 generate_audio，这些语义继承自 Draft。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

使用 seedance-2.5 文本生成视频创建 seedance-2.5 Draft 样片引用 Draft 创建 seedance-2.5 Final使用首帧和尾帧生成视频使用图片、视频和音频 URL 作为参考使用平台素材图片、视频和音频作为参考

{
    "model_id": "seedance-2.5",
    "params": {
        "content": [
            {
                "type": "text",
                "text": "一只橘猫在阳光下的窗台上伸懒腰，电影感"
            }
        ],
        "duration": 30,
        "resolution": "1080p",
        "ratio": "16:9",
        "generate_audio": true
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

curl --location 'https://api.naoshengyun.com/v1/video/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model_id": "seedance-2.5",
    "params": {
        "content": [
            {
                "type": "text",
                "text": "一只橘猫在阳光下的窗台上伸懒腰，电影感"
            }
        ],
        "duration": 30,
        "resolution": "1080p",
        "ratio": "16:9",
        "generate_audio": true
    }
}'

返回响应

🟢202

application/json

任务已创建或命中幂等结果

Bodyapplication/json

示例

{
    "code": 0,
    "message": "accepted",
    "data": {
        "id": "string",
        "model_id": "string",
        "status": "queued",
        "is_final": true,
        "created_at": 0,
        "video_url": "http://example.com",
        "error": {
            "code": "VIDEO_UPSTREAM_TASK_FAILED",
            "message": "string"
        }
    }
}

🟠413

🟠429

🔴503

🟠400BadRequest

🟠401Unauthorized

🟠402PaymentRequired

🟠403Forbidden

🔴500InternalError

修改于 2026-10-16 01:42:25

删除素材

查询视频任务