Overlay an image
POST /v1/process/overlay
Overlay one image on top of another at a specified position. The overlay image is classified for content moderation before processing. Control placement with x/y coordinates and transparency with opacity.
This is a free operation — no credits charged.
Authorizations
Section titled “Authorizations ”Request Body
Section titled “Request Body ”object
HTTPS URL of the base image.
Overlay opacity (0-1, default 1.0).
HTTPS URL of the image to overlay. Must be publicly accessible.
X coordinate for overlay placement (pixels).
Y coordinate for overlay placement (pixels).
Responses
Section titled “ Responses ”OK
object
MIME type of the output image.
ISO 8601 expiry time of the signed URL.
Signed URL of the processed image. Expires in 1 hour.
Processing operation performed.
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