文件影片建立任務
影音
POST /unified-video/generate
在客戶接受設定與價格後，真正建立影片任務。
POST /unified-video/generate權限: api.generate
適合情境
要實作送出流程、建立任務、成功狀態與最終扣點的團隊。
建立任務
顯示最終扣點
以 callback 為主接收完成結果
怎麼呼叫
bash
curl --request POST \
--url https://api-dev.midsync.ai/unified-video/generate \
--header "Authorization: Bearer <midsync_api_key>" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-1.5-pro",
"prompt": "黃昏海邊的電影感鏡頭，海浪輕拍岸邊",
"duration": 8,
"resolution": "720p"
}'這支 API 是做什麼的
應沿用已通過 quote 的同一份 request body。
成功後應保存 taskId、providerTaskId、model 與 pointsCharged，接著以 callback 當成主要完成通知。
Request 欄位
model
必填。選到的影片模型 id。
prompt
必填。主要生成提示詞。
duration
依模型而定，可能必填。
resolution
依模型而定，可能必填。
quality
選填。品質分級模型會用到。
aspectRatio
選填。只能送該模型支援的比例。
mode
選填。用於多模式模型。
generateAudio
選填布林值。只有支援音訊的模型才要送。
images
選填。圖片轉影片模型帶入圖片 URL。
referenceVideoUrls
選填。只有支援影片參考的模型才要送。
Response 欄位
success
任務建立是否成功。
taskId
內部任務 id，後續用來查 status。
providerTaskId
上游 provider 的 task id。
model
本次生成所使用的模型 id。
providerModel
實際對應的 provider model 名稱。
pointsCharged
本次真正扣除的點數。
status
初始任務狀態，通常是 submitted。
estimatedTime / estimatedTimeSec
若後端提供，則為估計處理時間。
前端怎麼用
- 送出時應停用主要按鈕。
- 建立成功後應直接顯示 pointsCharged。
- 主要完成流程應走 callback；/unified-video/:taskId/status 應視為 fallback、手動查詢或補救機制。
想直接開始測試？
先到 Settings 建立 general API key，再回到這裡直接複製請求範例。