DevelopersAPI Docs
Media

Upload Files

Many models accept reference images, videos, or audio files. Upload your file first to get a public URL, then pass that URL as a parameter to the generation endpoint.

Endpoint

http
POST https://bumi.digital/api/v1/upload

File Retention

Uploaded files are hosted through Wavespeed and are automatically deleted after 7 days. Reference the returned URL within that window; after expiry the file is no longer accessible.

File Size Limits

TypeMax Size
Image20 MB
Video100 MB
Audio50 MB

Example Request

bash
curl -X POST https://bumi.digital/api/v1/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Example Response

json
{
  "ok": true,
  "data": {
    "file_id": "c9b7xxxxx",
    "file_name": "c9b7xxxxx.jpg",
    "file_type": "image",
    "file_size": 1024000,
    "content_type": "image/jpeg",
    "file_url": "https://storage.bumi.digital/uploads/c9b7xxxxx.jpg",
    "upload_url": "https://storage.bumi.digital/uploads/c9b7xxxxx.jpg"
  }
}

Using the Uploaded URL

Use the returned file_url as the value of parameters such as image, reference_images, or reference_videos when calling a generation endpoint.