星算API檔案與參考素材
下載 Markdown ↓本地檔案不會自動成為上游能下載的 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 是臨時存取憑據，可能提供給上游讀取。僅上傳有權使用的素材，不要在公開紀錄暴露私有連結或金鑰。
臨時素材與保存#
臨時素材會過期及清理，不是長期託管。輸入素材、任務結果與自行保存的副本不同，請在有效期內下載歸檔。