Skip to main content
Upload local files to the AceDataCloud platform CDN to obtain a publicly accessible URL (in the style of https://cdn.acedata.cloud/uploads/<uuid>.png), which can be immediately referenced in parameters such as image_url and reference_url of other business APIs (such as Midjourney, Suno, and Flux). Applicable scenarios:
  • Upload a base image to the CDN to obtain a URL before calling Midjourney /midjourney/imagine.
  • Cache the video generated in the previous step for use as input in the next step.
  • Temporarily host user-uploaded assets to avoid building your own S3.
ℹ️ This API is an AceDataCloud Platform Management API, with the unified prefix https://platform.acedata.cloud/api/v1/.

API Overview

Authentication Instructions (How to Obtain an Account Token)

Request header:
How to obtain it: Log in to the AceDataCloud Platform → Account Token Console → Click the “Create” button. For details, see Manage AceDataCloud Platform Account Tokens.

Request Body (multipart/form-data)

The platform generates a unique file path on its own and retains safe extensions from the uploaded filename. For example, photo.jpg corresponds to uploads/<uuid>.jpg. The MIME type provided by the upload part is written into the file metadata; if it is not provided or is application/octet-stream, the platform infers the type using the filename and standard MIME mappings. Extension and MIME inference do not convert file contents; please ensure that the filename matches the actual format.

Request Examples

cURL

Python

Node.js

Response Example (HTTP 200, Excerpt)

Simply use the file_url field in other business APIs—the CDN URL is currently publicly accessible and requires no authentication; do not treat it as a commitment to permanent storage.

Response Field Description

Error Handling

Practical Tips

  • Upload images as base images: Midjourney image_urls, Flux image_url, and Veo reference_url all accept CDN URLs and do not accept base64. Obtaining a URL through this API first is standard practice.
  • Do not upload sensitive data: The returned URL is publicly accessible; the retention period is subject to the platform’s current storage policy. For long-term archiving, use your own object storage.
  • Bulk uploads: Control concurrency and set a timeout for each upload; throughput depends on file size and network conditions.