https://cdn.acedata.cloud/uploads/<uuid>.png 風格),可立即在其他業務介面(如 Midjourney、Suno、Flux)的 image_url、reference_url 等參數中引用。
適用情境:
- 在呼叫 Midjourney
/midjourney/imagine前先將墊圖上傳至 CDN 取得 URL。 - 將上一步生成的影片快取起來作為下一步的輸入。
- 暫時託管使用者上傳的素材,避免自行建置 S3。
ℹ️ 本介面屬於 AceDataCloud 平台管理 API,統一前綴 https://platform.acedata.cloud/api/v1/。
介面概覽
驗證說明(如何取得帳戶權杖)
請求標頭:請求主體(multipart/form-data)
平台自行產生唯一的檔案路徑,並保留上傳檔案名稱中安全的副檔名,例如
photo.jpg 對應 uploads/<uuid>.jpg。上傳部分提供的 MIME 類型會寫入檔案中繼資料;未提供或為 application/octet-stream 時,平台使用檔案名稱和標準 MIME 對應推斷類型。副檔名和 MIME 推斷不會轉換檔案內容,請確保檔案名稱與實際格式一致。
請求範例
cURL
Python
Node.js
回應範例(HTTP 200,節選)
file_url 欄位拿去其他業務介面中使用即可——CDN URL 目前可公開存取且無需驗證;不要將它當作永久封存承諾。
回應欄位說明
錯誤處理
實用提示
- 上傳圖片作為墊圖:Midjourney
image_urls、Fluximage_url、Veoreference_url都接受 CDN URL,不接受 base64。先使用本介面取得 URL 是常規操作。 - 不要上傳敏感資料:回傳 URL 可公開存取;保存期限以平台目前儲存策略為準,長期封存請使用自己的物件儲存。
- 大量上傳:控制並行數並為每次上傳設定逾時;吞吐量取決於檔案大小與網路環境。
相關介面
- 取得 AceDataCloud 平台服務清單 — 找到接受 URL 輸入的業務服務
- 建立 AceDataCloud 平台 API 憑證 — 上傳後通常下一步是建立憑證呼叫業務介面

