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.

Image
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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.promptstringNoOptional 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_urlstringYesImage URL to outpaint—
request_body.sync_modebooleanNoIf 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_topintegerNoNumber of pixels to add as black margin on the top side (0-700).0
request_body.num_imagesintegerNoNumber of images to generate.1
request_body.expand_leftintegerNoNumber of pixels to add as black margin on the left side (0-700).0
request_body.expand_rightintegerNoNumber of pixels to add as black margin on the right side (0-700).0
request_body.expand_bottomintegerNoNumber of pixels to add as black margin on the bottom side (0-700).400
request_body.output_formatenum (png | jpeg | jpg | webp)NoThe format of the output image.png
request_body.zoom_out_percentagenumberNoPercentage 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_checkerbooleanNoIf set to true, the safety checker will be enabled.true

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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.