Skip to main content
POST
Upload input media

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

multipart/form-data
file
file
required

The media file. Image (PNG/JPEG/WebP/GIF), video (MP4/WebM), or audio (MP3/WAV/OGG).

Response

Stored. Pass url as a media param on a generation request.

A stored, ephemeral input file. Pass url as a media parameter on a generation request.

bytes
integer

Stored file size in bytes.

content_type
string
Example:

"image/png"

expires_in
integer

Seconds the file is retained (~86400).

url
string<uri>

Short-lived URL to use as a media input (valid ~24h).