介紹
YUYU VIDEO 是一個 API-first 的圖生影片(image-to-video)平台,讓企業與開發者用一組 REST API,把一張靜態圖片轉換成影片,並以非同步任務的方式整合進你既有的產品或工作流程(非同步任務的意思是:你送出建立任務的請求後會立即拿到回應,實際產出在背景進行,完成後再透過查詢或 Webhook 取得結果,不需要一直占著連線等待)。
你可以用 YUYU VIDEO 做什麼
| 能力 | 說明 |
|---|---|
| 單張圖片生成影片 | 帶入一張參考圖與文字描述,建立一筆影片生成任務,詳見〈圖生影片〉 |
| 兩種模型配置 | YUYU_M1 固定 5 秒、固定有聲,適合快速產出;YUYU_N1 可調秒數(2–15 秒)、解析度、靜音與否,詳見〈圖生影片〉的 model 說明 |
| API Key 驗證 | 以 X-Api-Key header 驗證身份,區分付費與試用兩種類型,詳見〈驗證方式〉 |
| 付費與試用積分 | 任務建立時依模型與操作類型即時扣款,失敗或取消自動全額退還,詳見〈積分與計費〉 |
| 任務查詢與結果取件 | 用任務的 public_id 隨時查詢進度與下載結果檔,詳見〈任務查詢與取件〉 |
| 簽名 Webhook 與失敗自動退款 | 任務轉為完成或失敗時主動通知你的伺服器,通知內容可用 HMAC 簽名驗證來源,詳見〈回呼(Webhook)〉 |
為什麼選擇 YUYU VIDEO
- API-first:所有功能都透過 REST API 提供,方便你整合進自己的產品介面或後台流程,而不是要求終端使用者到另一個網站操作。
- 依需求選擇模型:
YUYU_M1用固定的秒數與畫面設定換取簡單快速的產出;YUYU_N1用可調的秒數、解析度、靜音選項換取更多控制權,兩者都是 YUYU VIDEO 提供的模型。 - 非同步流程,不卡住你的服務:建立任務會立即拿到回應,你可以選擇輪詢查詢或設定
callback_url被動接收通知,兩種方式都能取得同一份任務資料。 - 透明的任務扣款與退款:任務建立成功即扣款,金額會反映在任務物件的
credits欄位;任務失敗或被取消時,系統會自動把扣掉的積分全額退回,不需要你額外申請。 - 回呼失敗會自動重試:Webhook 送達失敗時系統會依退避排程自動重送,你的伺服器只需要保持冪等,不用自己實作重試邏輯。