Upload an image
POST /v1/upload
Upload an image for use as input to edit, combine, or process endpoints, or as a character reference image for stories. Send the image as multipart/form-data (field name: “image”).
Accepted formats: PNG, JPEG, WebP. Maximum file size: 50 MB. The image is scanned by the content classifier before storage — if it’s rejected, you’ll get a 451.
The response includes a signed URL (valid 1 hour) that you can pass as input_image_url to other endpoints.
Authorizations
Section titled “Authorizations ”Request Body
Section titled “Request Body ”object
Image file to upload (PNG, JPEG, or WebP). Maximum 50 MB.
Responses
Section titled “ Responses ”OK
object
ISO 8601 expiry time of the signed URL.
Upload identifier (object storage key).
Signed URL of the uploaded image. Expires in 1 hour.
Bad Request
object
Unauthorized
object
Payment Required
object
Forbidden
object
Not Found
object
Conflict
object
Unprocessable Entity
object
Too Many Requests
object
Unavailable For Legal Reasons
object
Internal Server Error
object
Bad Gateway
object
Service Unavailable