fileId used when creating generations.
Overview
Step 1: Prepare Upload
Response
string
required
Short-lived signed URL for uploading directly to cloud storage.
string
required
Opaque key identifying this upload. Pass it to the complete step.
Step 2: Upload to Storage
PUT the raw file directly to the signed URL. This goes to cloud storage, not through the app proxy.Content-Type: application/octet-stream.
Supported formats: JPEG, PNG, WebP, HEIC/HEIF. Max size: 20 MB.
Step 3: Complete Upload
string
required
The
uploadKey from Step 1.Response
string
required
Unique identifier for the processed file. Use this when creating generations. Treat it as an opaque string and pass it back exactly as received.
string
required
Signed URL for previewing the processed image.
string
required
Status message.

