本指南使用 cURL 建立一個影片任務、輪詢任務狀態並下載結果。

前置條件

  • 一個可正常登入的黑豬AI賬戶
  • 足夠支付測試任務的賬戶餘額
  • 服務端、終端或 API 除錯工具
  • 已瞭解目標模型的支援時長和計費型別

1. 建立 API Token

登入 黑豬AI控制檯,進入令牌管理並建立 Token。將它儲存到環境變數:
不要在瀏覽器前端、公開程式碼、截圖或聊天記錄中暴露 Token。示例中的 Token 只是佔位符。

2. 獲取模型列表

模型列表只表示當前令牌可見的模型。價格、計費單位、支援時長和模型說明請同時檢視 模型廣場。

3. 建立影片任務

以下示例使用按次計費模型,並透過公網 URL 傳入一張參考圖:
成功後會返回非同步任務物件。儲存其中的 id:

4. 查詢任務

建議每 5 至 10 秒查詢一次。queued 和 in_progress 表示任務仍在處理,請勿因此重複建立任務。

5. 下載結果

當狀態變為 completed 後:
至此,你已經完成了完整的非同步影片生成流程。生產環境還應加入超時控制、錯誤記錄和指數退避。

瞭解素材要求

正確傳入圖片、音訊和影片 URL。

處理任務狀態

設計可靠的輪詢和業務狀態流轉。