---
title: 參考素材
description: 使用公網 URL 傳入參考圖片、音訊和影片。
icon: images
---

影片任務可透過 URL 傳入參考圖片、音訊和影片。是否支援某類素材、支援數量及格式取決於所選模型。

## 標準欄位

| 欄位 | 型別 | 用途 |
| --- | --- | --- |
| `image_urls` | `string[]` | 參考圖片地址陣列 |
| `audio_urls` | `string[]` | 參考音訊地址陣列 |
| `video_urls` | `string[]` | 參考影片地址陣列 |

```json
{
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "audio_urls": ["https://cdn.example.com/reference.mp3"],
  "video_urls": ["https://cdn.example.com/reference.mp4"]
}
```

## URL 要求

素材地址必須：

- 使用公網可訪問的 `http://` 或 `https://` URL。
- 無需登入、Cookie、內網訪問或人工確認。
- 在任務處理期間持續有效。
- 返回真實媒體內容，而不是 HTML 下載頁。
- 允許外部模型服務讀取，不限制特定來源 IP 或 User-Agent。

<Info>
黑豬AI接收並傳遞素材 URL，不要求你的客戶端先把素材下載到本地。實際生成服務會透過 URL 讀取素材，因此短時效簽名連結可能在排隊期間失效。
</Info>

## 不支援本地路徑

以下值不能被模型服務訪問：

```text
/Users/name/Desktop/reference.jpg
C:\Users\name\reference.jpg
file:///tmp/reference.jpg
http://127.0.0.1/reference.jpg
```

如素材當前只存在於本地，請先上傳至你控制的物件儲存或公網 CDN，再把 URL 放入請求。

## 常見問題

<AccordionGroup>
  <Accordion title="瀏覽器中能開啟，為什麼模型仍然讀取失敗？">
    瀏覽器可能帶有登入 Cookie、快取或 Referer。請在無痕視窗中測試，並確認使用 `curl -I` 或服務端請求也能直接訪問。
  </Accordion>
  <Accordion title="可以使用帶簽名的臨時 URL 嗎？">
    可以，但有效期必須覆蓋任務排隊和生成時間。建議留出充足餘量，不要使用幾分鐘內失效的連結。
  </Accordion>
  <Accordion title="素材數量由誰決定？">
    由模型能力決定。提交前檢視模型廣場描述；超出模型限制時，任務可能返回引數錯誤或最終失敗。
  </Accordion>
</AccordionGroup>