POST
创建视频任务
建立一個非同步影片生成任務。介面接受 JSON 請求,並在成功提交後返回任務 ID。

請求引數

string
必填
模型廣場中的完整模型名稱。
string
必填
影片生成提示詞。建議明確描述主體、動作、鏡頭、場景和期望風格。
integer
必填
計費與呼叫時長引數。按次模型傳 1;按秒模型傳實際秒數,並與 video_duration 保持一致。
integer
必填
目標影片秒數。必須符合所選模型在模型廣場中標註的支援範圍。
string
畫面比例。標準值包括 16:9、9:16、4:3、3:4 和 1:1,具體支援情況由模型決定。
string
輸出解析度。可使用 480p、720p 或 1080p;未顯式提供時,部分模型可從模型名稱推斷。
string[]
公網可訪問的參考圖片 URL 陣列。
string[]
公網可訪問的參考音訊 URL 陣列。
string[]
公網可訪問的參考影片 URL 陣列。

請求示例

成功響應

string
必填
平臺任務 ID。後續查詢和獲取結果時必須使用此值。
string
必填
物件型別,固定為 video。
string
必填
本次任務使用的模型。
string
必填
初始狀態通常為 queued。
integer
必填
當前進度百分比。
integer
必填
Unix 時間戳。
同一次業務操作只應建立一個任務。客戶端超時或查詢失敗不代表任務未建立,請結合服務端響應與業務日誌判斷,避免重複計費。

授權

Authorization
string
header
必填

在控制台创建的黑猪AI API Token。

主體

application/json
model
string
必填

模型广场中的完整模型名称。

範例:

"L-stable-seedance-2-0-933-720p"

prompt
string
必填

视频生成提示词。

Minimum string length: 1
duration
integer
必填

按次模型传 1;按秒模型传实际秒数。

必填範圍: x >= 1
video_duration
integer
必填

目标视频秒数,必须符合模型支持范围。

必填範圍: x >= 1
aspect_ratio
enum<string>

目标画面比例。

可用選項:
16:9,
9:16,
4:3,
3:4,
1:1
resolution
enum<string>

目标输出分辨率。

可用選項:
480p,
720p,
1080p
image_urls
string<uri>[]

公网参考图片 URL。

Pattern: ^https?://
audio_urls
string<uri>[]

公网参考音频 URL。

Pattern: ^https?://
video_urls
string<uri>[]

公网参考视频 URL。

Pattern: ^https?://

回應

任务创建成功

id
string
必填

平台任务 ID。

object
string
必填
Allowed value: "video"
model
string
必填

任务使用的模型。

status
enum<string>
必填
可用選項:
queued,
in_progress,
completed,
failed,
unknown
progress
integer
必填
必填範圍: 0 <= x <= 100
created_at
integer<int64>
必填

创建时间的 Unix 时间戳。

completed_at
integer<int64>

任务结束时间的 Unix 时间戳。

error
object