影片

提交影片生成請求

提交非同步的影片生成任務。立即回傳 202 與任務 id(vjob_ 開頭);之後以 GET /api/v1/videos/{id} 輪詢直到 status 為 completed,再從 unsigned_urls 下載。計費:提交時依 duration × resolution 預留額度,完成時按實際交付秒數結算(輪詢回應的 usage.cost)。

POST/api/v1/videos

驗證

Authorization必填

string · header

在 Authorization 標頭以 Bearer token 傳入 API 金鑰。

Body

model必填

string

影片生成模型 ID(供應商前綴格式)。

Example: "alibaba/wan2.7-t2v"

prompt必填

string

描述影片內容的文字提示。

duration

integer

影片長度(秒)。預設 2。各模型有自己的上下限——例如參考圖生影片(r2v)限 2–10 秒;超出範圍在扣款前就回 400。

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

輸出畫質檔位,預設 "720p"。各模型支援的檔位不同;送出不支援的檔位會在扣款前回 400,錯誤訊息會列出該模型支援的檔位。

480p720p1080p

Example: "720p"

aspect_ratio

string

長寬比。常見值:"16:9"、"9:16"、"1:1"、"4:3"、"3:4";實際可用集合依模型而定(部分模型另支援 "21:9" 等寬幅)。不支援的組合在扣款前回 400;有輸入畫格的模式以畫格為準而忽略此欄。

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

首/尾關鍵畫格圖片(image-to-video、keyframe-to-video)。接受純 URL 字串,或物件 { type: "image", image_url: { url }, frame_type: "first" | "last" }。

input_references

object[] | string[]

參考素材(reference-to-video):引導生成的參考物件,建議用物件形式 { type: "image", image_url: { url } }(也接受純 URL 字串,視為圖片參考)。圖片參考支援面最廣;音訊/影片參考物件會原樣轉發,僅在支援它們的模型上生效,其他模型只取圖片參考。僅具 r2v 能力的模型支援此欄。

input_video

string | object

來源影片(影片編輯模型專用,BazaarLink 擴充欄位)。接受 URL 字串、{ video_url: { url } } 或 { url }。非影片編輯模型會忽略。編輯計費按「來源秒數 + 輸出秒數」。

generate_audio

boolean

是否同時生成音訊。僅支援音訊的模型有效;含音訊的秒數費率較高。

watermark

boolean

是否在輸出加上浮水印。預設 false——BazaarLink 會主動關閉上游的預設浮水印,除非你明確傳 true。

seed

number

取樣種子。是否保證可重現依模型而定。

callback_url

string

任務終態時呼叫的 webhook 網址,免除輪詢。僅接受 HTTPS,且會做 SSRF 安全檢查(禁止內網/私有位址),不合格在扣款前就回 400。只會在贏得該任務終態判定的那次呼叫觸發,恰好一次;失敗會重試(2 次,間隔 2 秒/8 秒),全部失敗也不影響計費或任務本身狀態。v1 沒有簽章——回呼只是提示,收到後請帶你的 API 金鑰呼叫 GET /v1/videos/{id} 回查確認狀態與金額再採取行動。⚠️ webhook payload 裡的 unsigned_urls 是絕對網址,跟輪詢回應裡的相對路徑不同。

https:// only, ≤2048 chars

深度指南 →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

回應範例

任務已受理(非同步)。用回傳的 polling_url(即 GET /api/v1/videos/{id})輪詢狀態,建議間隔 ≥5 秒。

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}