黑豬AI提供統一的影片生成 API。你可以從服務端提交提示詞與公網參考素材，非同步查詢任務狀態，並在任務完成後獲取影片內容。

快速接入

使用 cURL 在幾分鐘內完成第一個影片任務。

API 參考

檢視請求引數、響應欄位和可執行示例。

模型與價格

查詢當前可用模型、計費單位與公開售價。

​
核心能力

  • 統一入口：透過同一組介面呼叫模型廣場中的影片模型。
  • 非同步任務：建立、查詢和結果獲取相互分離，適合長時間影片生成任務。
  • 參考素材：支援以公網 URL 傳入參考圖片、音訊和影片。
  • 透明計費：按模型規則區分按次與按秒計費，任務失敗後按平臺規則退款。

​
API 地址

開發文檔發布於 https://docs.heizhu.lol，API 請求請統一使用 https://api.heizhu.lol。
所有介面均使用 HTTPS。請求和示例中的令牌必須替換為你在控制檯建立的 API Token。

​
標準工作流

1

建立令牌

登入控制檯並建立一個僅供服務端使用的 API Token。
2

選擇模型

在模型廣場確認模型名稱、計費型別、支援時長和素材要求。
3

建立任務

呼叫 POST /v1/videos，儲存響應中的任務 id。
4

等待結果

呼叫 GET /v1/videos/{task_id}，直到狀態變為 completed 或 failed。
5

獲取影片

任務完成後呼叫 GET /v1/videos/{task_id}/content 讀取影片內容。

​
獲得幫助

遇到接入問題時，請準備請求時間、模型名稱、任務 ID 和錯誤響應，再透過 線上客服 或 郵件 聯絡技術支援。不要傳送完整 API Token。