About cos-upload
cos-upload uploads a local file to AceData CDN and returns a public URL. It is intended for workflows that pass assets between APIs or retain intermediate files, with notes on tokens, file limits, and public access.
Key features
- 01Upload one local file
- 02Return a public CDN URL
- 03Preserve safe file extensions
- 04Set MIME type metadata
Use cases
- 01Pass a generated image to a video API
- 02Publish a finished video or cover
- 03Save intermediate files for later retrieval
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ acedatacloud/ skills --skill cos-uploadAfter installing, type/cos-uploadin Claude Code to confirm it loaded.
Details
From the project READMEUpload a file → AceData CDN URL
Turn a local file into a public https://cdn.acedata.cloud/... URL.
Upload (multipart, synchronous)
curl -s -X POST https://platform.acedata.cloud/api/v1/files/ \
-H "Authorization: Bearer $ACEDATACLOUD_PLATFORM_TOKEN" \
-F "file=@/path/to/video.mp4"
On HTTP 200, use the returned file_url rather than constructing a URL. The platform generates a unique uploads/<uuid> path and preserves the uploaded filename's safe extension. The returned mime is the MIME type written to object-storage metadata. One file per request (loop for several); the default limit is 100 MB per file.
Use a filename whose extension matches the actual content. The upload part's MIME type is stored as supplied; if omitted or application/octet-stream, the platform infers it from the filename using standard MIME mappings. Neither extension handling nor MIME inference converts the file's bytes.
When to use
- Feed a generated asset into another API by URL — e.g. upload a gpt-image-2 still, then pass its URL to
seedance/klingimage-to-video. - Publish/return a finished artifact (final video, cover image).
- Persist intermediate artifacts so a later run can re-download and continue.
Notes
- Auth uses the platform token (
ACEDATACLOUD_PLATFORM_TOKEN), not the per-service API token — the files endpoint is onplatform.acedata.cloud, notapi.acedata.cloud. - If your runtime ships a bundled uploader (e.g. a worker that owns the storage creds), prefer it — it avoids handling the platform token directly.
- The returned URL is publicly accessible without authentication; do not upload sensitive data. Retention follows the platform's current storage policy, not a permanent-archive guarantee; use your own object storage for long-term archiving.