Create Banner Job
DevelopingPOST
/banners/with-mask/createCreate banners from input mask and image.
Request
Input image file.
PNG mask image with transparent pixels.
Input image URL. Note: either input_image or input_imaeg_url can be given at the same time.
PNG mask image URL. Note: either mask_image_url or mask_image can be given at the same time.
Pixels (px): This is the most common unit. A value like 8px
sets a fixed margin of 8 pixels on all sides of the element (top, right, bottom, and left). This margin size remains constant regardless of the element's dimensions or the size of the viewport (the visible area of the browser window).
Percentages (%): This unit defines the margin as a percentage of the element's size (width or height, depending on the side). For example, 8%
sets a margin that is 8% of the element's width on the left and right sides, and 8% of its height on the top and bottom sides. This allows the margin to scale proportionally as the element's size changes, maintaining a consistent relative spacing.
Choose the customized AI model or let us decide
Enhance the AI model's precision by supplying up to five hints or pieces of additional information. These hints serve as valuable guidance, allowing the AI to more accurately pinpoint and concentrate on the relevant subject matter. By acting as clues, they assist the AI in refining its analysis, leading to outcomes of greater accuracy and detail.
Allocate specific labels to this job. These assigned labels will be included in the job's response, enabling you to efficiently search and retrieve jobs based on these labels. It's possible for multiple jobs to share a common label, facilitating the organization and querying of jobs that are related or fall under a similar category.
Optional webhook to be notified when a job either completes successfully or fails. The webhook should be capable of handling POST
requests and accepting data in the application/json
format. For successful communication, the webhook must return an HTTP
Status 200
response. If it doesn't, the system will attempt to resend the notification three more times, with each attempt spaced approximately 30 minutes apart, before it considers the webhook notification as failed.
When provided, the webhook will be invoked with a specific secret value included in the X-WEBHOOK-SECRET
request header. Utilize this secret to authenticate and validate the incoming callback request, ensuring it's from a trusted source.
Request samples
Responses
Assigned Job ID to the request.
{
"job_id": "string"
}