创建视频任务

正式环境

https://api.naoshengyun.com

POST

/v1/videos

创建异步视频生成任务，成功后返回平台任务 ID。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "model": "wan3.0-video",
    "prompt": "一只橘猫在草地上奔跑，阳光明媚，电影质感",
    "image": "https://example.com/first-frame.jpg",
    "images": [
        "https://example.com/first.jpg",
        "https://example.com/last.jpg"
    ],
    "input_reference": "http://example.com",
    "size": "1920*1080",
    "seconds": 5,
    "metadata": {
        "input": {
            "media": [
                {
                    "type": "first_frame",
                    "url": "http://example.com"
                }
            ],
            "audio_url": "http://example.com"
        },
        "parameters": {
            "prompt_extend": true,
            "watermark": true,
            "seed": 0,
            "ratio": "adaptive",
            "resolution": "480P",
            "size": "string",
            "duration": 0
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.naoshengyun.com/v1/videos' \
--header 'Authorization: Bearer sk-xxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan3.0-video",
    "prompt": "一只橘猫在草地上奔跑，阳光明媚，电影质感",
    "image": "https://example.com/first-frame.jpg",
    "images": [
        "https://example.com/first.jpg",
        "https://example.com/last.jpg"
    ],
    "input_reference": "http://example.com",
    "size": "1920*1080",
    "seconds": 5,
    "metadata": {
        "input": {
            "media": [
                {
                    "type": "first_frame",
                    "url": "http://example.com"
                }
            ],
            "audio_url": "http://example.com"
        },
        "parameters": {
            "prompt_extend": true,
            "watermark": true,
            "seed": 0,
            "ratio": "adaptive",
            "resolution": "480P",
            "size": "string",
            "duration": 0
        }
    }
}'

返回响应

🟢200成功

application/json

任务创建成功。

Bodyapplication/json

示例

{
    "id": "string",
    "object": "video",
    "model": "string",
    "status": "queued",
    "progress": 0,
    "created_at": 0,
    "completed_at": 0,
    "task_id": "string"
}

🟠400参数错误

🟠401鉴权失败

修改于 2026-09-16 08:41:24

火山原生查询视频任务

查询视频任务