Skip to main content
POST
/
v1
/
uploads
Create Upload URL
curl --request POST \
  --url https://api.modal.beeble.ai/v1/uploads \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "filename": "<string>"
}
'
{
  "id": "<string>",
  "upload_url": "<string>",
  "beeble_uri": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Your Developer API key.

Body

application/json

Request to create a presigned upload URL.

​
filename
string
required

Filename with extension (3–255 chars). Accepted: .mp4, .mov, .png, .jpg, .jpeg, .webp

Response

200 - application/json

Successful Response

Response with presigned upload URL and beeble:// URI.

​
id
string
required

Upload ID (upload_...)

​
upload_url
string
required

Presigned PUT URL for uploading your file. Expires after 1 hour.

​
beeble_uri
string
required

beeble:// URI to reference this file in SwitchX generation calls (source_uri, reference_image_uri, or alpha_uri).