Image Apps V2 Outpaint
42.00 credits/MP
ae_image_apps_v2_outpaint
Extend an image beyond its borders by generating new surrounding content. Choose how much to expand each side or zoom out, and optionally guide the result with a prompt.
42.00 credits/MP
Pricing
42.00 AE credits per MP. Charge for successfully returned images. Round each image up to a whole MP, then sum. One MP is 1,000,000 pixels.
42.00 credits/MP
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.prompt | string | No | Optional prompt to guide the outpainting. If provided, it will be appended to the base outpaint instruction. Example: 'with a beautiful sunset in the background' | "" |
request_body.image_url | string | Yes | Image URL to outpaint | — |
request_body.sync_mode | boolean | No | If True, the function will wait for the image to be generated and uploaded before returning the response. If False, the function will return immediately and the image will be generated asynchronously. | false |
request_body.expand_top | integer | No | Number of pixels to add as black margin on the top side (0-700). | 0 |
request_body.num_images | integer | No | Number of images to generate. | 1 |
request_body.expand_left | integer | No | Number of pixels to add as black margin on the left side (0-700). | 0 |
request_body.expand_right | integer | No | Number of pixels to add as black margin on the right side (0-700). | 0 |
request_body.expand_bottom | integer | No | Number of pixels to add as black margin on the bottom side (0-700). | 400 |
request_body.output_format | enum (png | jpeg | jpg | webp) | No | The format of the output image. | png |
request_body.zoom_out_percentage | number | No | Percentage to zoom out the image. If set, the image will be scaled down by this percentage and black margins will be added to maintain original size. Example: 50 means the image will be 50% of original size with black margins filling the rest. | 20 |
request_body.enable_safety_checker | boolean | No | If set to true, the safety checker will be enabled. | true |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_image_apps_v2_outpaint' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"image_url": "https://v3.fal.media/files/koala/oei_-iPIYFnhdB8SxojND_qwen-edit-res.png"
}
}
}'No response example available yet.







