---
title: 黑豬AI API
description: 使用統一介面接入 Seedance 影片生成模型。
icon: house
---

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

<CardGroup cols={3}>
  <Card title="快速接入" icon="rocket" href="/getting-started/quickstart">
    使用 cURL 在幾分鐘內完成第一個影片任務。
  </Card>
  <Card title="API 參考" icon="braces" href="/api/create-video">
    檢視請求引數、響應欄位和可執行示例。
  </Card>
  <Card title="模型與價格" icon="badge-dollar-sign" href="https://api.heizhu.lol/pricing">
    查詢當前可用模型、計費單位與公開售價。
  </Card>
</CardGroup>

## 核心能力

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

## API 地址

```text
https://api.heizhu.lol
```

開發文檔發布於 `https://docs.heizhu.lol`，API 請求請統一使用 `https://api.heizhu.lol`。

<Info>
所有介面均使用 HTTPS。請求和示例中的令牌必須替換為你在控制檯建立的 API Token。
</Info>

## 標準工作流

<Steps>
  <Step title="建立令牌">
    登入控制檯並建立一個僅供服務端使用的 API Token。
  </Step>
  <Step title="選擇模型">
    在模型廣場確認模型名稱、計費型別、支援時長和素材要求。
  </Step>
  <Step title="建立任務">
    呼叫 `POST /v1/videos`，儲存響應中的任務 `id`。
  </Step>
  <Step title="等待結果">
    呼叫 `GET /v1/videos/{task_id}`，直到狀態變為 `completed` 或 `failed`。
  </Step>
  <Step title="獲取影片">
    任務完成後呼叫 `GET /v1/videos/{task_id}/content` 讀取影片內容。
  </Step>
</Steps>

## 獲得幫助

遇到接入問題時，請準備請求時間、模型名稱、任務 ID 和錯誤響應，再透過 [線上客服](https://hello.heizhu.lol) 或 [郵件](mailto:heizhuai@proton.me) 聯絡技術支援。不要傳送完整 API Token。