文件影片估價
影音
POST /unified-video/quote
用與 generate 相同的 request body，在正式送出前預先取得點數估價。
POST /unified-video/quote權限: api.generate
適合情境
要做即時價格預覽、送出前檢查與友善錯誤訊息的團隊。
即時點數預覽
送出前權威價格
友善錯誤提示
怎麼呼叫
ts
const quote = await fetch("/unified-video/quote", {
method: "POST",
credentials: "include",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
model: "seedance-1.5-pro",
prompt: "一隻狗在明亮攝影棚裡奔跑的電影感鏡頭",
duration: 8,
resolution: "720p"
})
}).then((resp) => resp.json());這支 API 是做什麼的
quote 的 body 應與 generate 相同。
當模型、時長、解析度、品質、音訊或模式改變時，都應重新估價。
Request 欄位
model
必填。影片模型 id，例如 seedance-1.5-pro 或 grok-video。
prompt
必填。主要生成提示詞。
duration
依模型而定，可能必填。請使用 /unified-video/models 回傳的可用值。
resolution
依模型而定，可能必填。
quality
選填。像 Runway 這類模型會使用。
aspectRatio
選填。只應送該模型支援的比例。
mode
選填。當模型有多種模式時使用。
generateAudio
選填布林值。只有支援音訊計價的模型才要送。
images
選填。當模型支援圖片轉影片時，帶入圖片 URL 陣列。
referenceVideoUrls
選填。只有支援影片參考計價的模型才要送。
Response 欄位
success
估價是否成功。
model
本次估價使用的模型 id。
pointsCharged
這份 request body 對應的估計點數。
error
若組合不合法，應把錯誤轉成客戶看得懂的提示。
前端怎麼用
- 建議 debounce 約 300 到 500ms。
- 如果 /models 已知某組合不合法，前端應先擋掉，不用等 quote 才知道。
- 估價結果應放在主要 CTA 附近。
想直接開始測試？
先到 Settings 建立 general API key，再回到這裡直接複製請求範例。