# 檔案與參考素材

本地檔案不會自動成為上游能下載的 URL。

## 輸入方式

| 方式 | 條件 |
| --- | --- |
| HTTPS URL | 上游可下載，讀取時仍有效 |
| Base64 / data URL | 模型明確支援，大小符合限制 |
| multipart | 端點及適配明確支援檔案欄位 |

純文字不需要物件儲存。圖片、影片、音訊參考是否需要 URL，由上游決定。

## 使用自己的儲存

可使用自己的物件儲存或 CDN，無須平台同時啟用。確認上游可存取，並符合格式、大小、解析度與時長限制。

私有桶可使用簽名 URL，有效期需涵蓋排隊、下載及重試，而非僅提交時間。

## 平台代傳

平台可選支援阿里雲 OSS、騰訊雲 COS 及 S3 相容儲存。管理員設定啟用，且模型適配支援時，才可轉成臨時 URL。

此功能不是通用檔案空間。目前 `/v1/files` 不是可用的通用上傳 API，請使用模型詳情中的方式。

## URL 讀取失敗

檢查過期、登入、防盜鏈及 IP 限制。`localhost`、`127.0.0.1`、內網位址與本地磁碟路徑不是公網素材 URL。

簽名 URL 是臨時存取憑據，可能提供給上游讀取。僅上傳有權使用的素材，不要在公開紀錄暴露私有連結或金鑰。

## 臨時素材與保存

臨時素材會過期及清理，不是長期託管。輸入素材、任務結果與自行保存的副本不同，請在有效期內下載歸檔。