提交萬相 3.0 原生影片任務

按百鍊原生參數非同步提交萬相 3.0 影片任務；使用返回的任務 ID 查詢結果。

POST /api/v1/services/aigc/video-generation/video-synthesis

鉴权: Bearer sk-xxx

本頁說明萬相 3.0 原生影片提交介面；它與 `/v1/videos/generations` 通用介面使用不同的響應結構。本站提交時無需客戶端傳送 `X-DashScope-Async`；閘道器轉發百鍊時會設定 `X-DashScope-Async: enable`。直接請求百鍊官方地址仍須按其文件攜帶該頭。 | 入口 | 新非同步任務提交 HTTP 狀態 | 查詢用的任務 ID | 提交狀態欄位 | |---|---:|---|---| | 本頁原生 `POST /api/v1/services/aigc/video-generation/video-synthesis` | `200` | `output.task_id` | `output.task_status=PENDING` | | 舊通用 `POST /v1/videos/generations` | 通常 `202` | 頂層 `id` | 頂層 `status=submitted` | 兩條入口共用本站任務與計費流程，但分別按各自協議構造客戶響應。**原生響應採用百鍊的欄位層級，不是把百鍊原始 HTTP 正文逐字節透傳。**例如本頁 `request_id` 是本站請求追蹤標識，`output.task_status` 由本站任務狀態轉換；請按所呼叫入口讀取 ID，後續查詢路徑也不能混用。 ## 兩步呼叫 1. **提交：**`POST /api/v1/services/aigc/video-generation/video-synthesis`，儲存響應中的 `output.task_id`。 2. **查詢：**`GET /api/v1/tasks/{task_id}`，用同一帳號的 `Authorization: Bearer <TOKEN>`。`PENDING`／`RUNNING` 時繼續查同一 ID；`SUCCEEDED` 時讀取 `output.video_url` 與頂層 `usage`。完整 GET 命令及成功、處理中、失敗響應見[查詢萬相 3.0 原生影片任務](/docs/get-wan3-native-task)。 提交請求僅含頂層 `model`、`input`、`parameters`；`duration` 與 `resolution` 只放在 `parameters` 內。客戶端無需傳非同步請求頭；受理後返回 `output.task_id`，再按本頁下方的查詢示例請求 `GET /api/v1/tasks/{task_id}`。不支援 `wait=true`；任務已受理時不要重複 POST。 `parameters.duration` 可填 2–30 的整數或 `-1`（智慧時長），省略預設為 5 秒；`parameters.resolution` 可用 `480P`、`720P`、`1080P`，省略預設為 `1080P`。有參考影片時，輸入與輸出總時長不能超過 30 秒。最終費用以成功任務的實際用量為準。 可用模型為 `wan3.0-video`、`wan3.0-video-prime`。本頁任務 ID、請求 ID、時間、提示詞及地址均為虛構示例；欄位層級對照[百鍊萬相 3.0 官方文件](https://docs.modelstudio.console.alibabacloud.com/zh/model-studio/wan3-video-generation-api-reference)和本站已驗收的原生返回結構。

请求体

modelstringrequired模型 ID。
inputobjectrequired生成輸入；`prompt` 與 `media` 至少提供一項。
input.promptstring描述影片內容的提示詞。
input.mediaarray可選參考素材；每項包含 `type` 和 `url`。
input.media[].typestring素材用途。首幀／尾幀與參考素材不能混用。
input.media[].urlstring可公開讀取的 HTTPS 素材 URL；圖片也可使用符合格式的資料 URI。
parametersobject影片參數物件；建議顯式傳入時長與解析度。
parameters.durationinteger輸出時長：2–30 的整數；`-1` 為智慧時長。預設 5 秒。有影片輸入時，輸入與輸出總時長不超過 30 秒。
parameters.resolutionstring輸出解析度，預設 `1080P`。
parameters.ratiostring畫面比例，可用 `adaptive`、`16:9` 等官方支援的值。
parameters.audioboolean是否生成音訊。
parameters.prompt_extendboolean是否開啟提示詞改寫；使用 `file` 或 `link` 時必須為 `true`。
parameters.seedinteger可選隨機種子。
parameters.watermarkboolean是否新增水印。

响应

调用示例

curl --request POST 'https://api.router.ai/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "wan3.0-video",
    "input": {"prompt": "蓝色圆点沿白色背景向右移动，简洁动画。"},
    "parameters": {"resolution": "480P", "ratio": "adaptive", "duration": 2, "prompt_extend": true}
  }'

## 查詢結果 提交後儲存 `output.task_id`，按[查詢萬相 3.0 原生影片任務](/docs/get-wan3-native-task)輪詢同一任務；不要重複提交。 ## 智慧時長與參考素材 把提交示例中的 `parameters.duration` 改為 `-1` 即可啟用智慧時長。`input.media` 可傳帶 `type` 和 `url` 的素材物件；首幀／尾幀不能與參考素材混用。傳 `file` 或 `link` 時須設 `parameters.prompt_extend=true`。完整素材組合、格式、大小限制以百鍊官方文件為準。 ## 提交錯誤 額外傳頂層 `duration`／`resolution`、傳入 `wait` 或無效時長時會在提交前拒絕。右側響應選項卡描述本頁的 POST 提交；GET 的完整響應見獨立查詢文件。

API 文件