跳轉到主要內容
將本機檔案上傳至 AceDataCloud 平台 CDN,取得一個可公開存取的 URL(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/。

介面概覽

驗證說明(如何取得帳戶權杖)

請求標頭:
取得方式:登入 AceDataCloud 平台 → Account Token 控制台 → 點選「建立」按鈕。詳見管理 AceDataCloud 平台帳戶權杖。

請求主體(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、Flux image_url、Veo reference_url 都接受 CDN URL,不接受 base64。先使用本介面取得 URL 是常規操作。
  • 不要上傳敏感資料:回傳 URL 可公開存取;保存期限以平台目前儲存策略為準,長期封存請使用自己的物件儲存。
  • 大量上傳:控制並行數並為每次上傳設定逾時;吞吐量取決於檔案大小與網路環境。

相關介面