Skip to main content
POST
Create an upload

Authorizations

Authorization
string
header
required

An organization API key created in Settings → Team, sent as Authorization: Bearer <key>.

Body

application/json
content_type
string
required
Example:

"image/png"

filename
string
required
Maximum string length: 255
Example:

"reference.png"

size_bytes
integer
required
duration_seconds
number | null

For video and audio: the file's duration, measured on your side.

Required range: x > 0

Response

Successful Response

asset_id
string
required

Use this as a reference input (for example reference_images or first_frame) once the PUT has completed.

required_headers
Required Headers · object
required
upload_url
string
required

PUT the file bytes here with exactly the listed headers.

url
string
required

Where the file will live after the PUT. Informational; generation inputs take asset_id.