Get a signed upload URL

Request a pre-signed URL to upload a source image directly to secure cloud storage. Use the returned future_upload_file_key as the image or input_images value in any generation endpoint.

Upload flow:

  1. Call this endpoint with your file's MIME type and size.
  2. PUT the raw file bytes to the returned uploadUrl (no authentication headers needed — the URL is already signed).
  3. Pass future_upload_file_key as the image source in your generation request.

Constraints:

  • Maximum file size: 30 MB
  • Supported types: jpeg, jpg, png, gif, webp, heic, heif
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required

MIME type of the file you intend to upload.

Allowed:
integer
required
1 to 31457280

File size in bytes. Must not exceed 31,457,280 (30 MB).

Headers
string
required
^[a-zA-Z0-9_\-~]+$

A stable, unique identifier for the end-user making the request. Accepts alphanumeric characters, dashes (-), underscores (_), and tildes (~). This maps the request to the correct credit balance and output history.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json