POST/outpaint4 creditsMidjourney only

Outpaint (Zoom Out)

Expand an upscaled Midjourney image outward, generating new content around the edges to create a wider scene. Use this to reframe tightly cropped subjects, build out environmental context, or adapt a portrait-oriented image to landscape for different social media formats. Returns a new 2×2 grid of outpainted variations. Requires a prior /upscale-1x task as parent. Midjourney only.

Request Parameters

Parameter	Type	Required	Description
parent_task_id	`string`	Required	Task ID of the image to outpaint.
zoom_ratio	`number`	Required	How much to zoom out. 1 = make square (no zoom), 1.5 = 1.5x zoom, 2 = 2x zoom. `11.52`
aspect_ratio	`string`	Optional	Aspect ratio for the outpainted result.Default: `1:1`
prompt	`string`	Optional	Optional prompt for the newly generated border areas.
webhook_url	`string`	Optional	URL where we POST the completed task result.
webhook_secret	`string`	Optional	Sent as x-webhook-secret header in webhook delivery.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/outpaint \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_task_id": "772a0622-a41d-63f6-c938-668877662222",
    "zoom_ratio": 2,
    "prompt": "surrounded by a lush forest",
    "webhook_url": "https://your-server.com/webhook"
  }'

Immediate Response

Returns immediately with a task ID. Use /fetch or webhooks to get the result.

200 OK

{
  "task_id": "cc7f5b77-f96i-18k1-h483-113322117777"
}

Response Fields

Field	Type	Description
task_id	`string`	UUID of the outpaint task.
task_type	`string`	"outpaint-2" (regardless of zoom level).
original_image_url	`string`	URL of the new 2×2 grid.
image_urls	`string[]`	Array of 4 individual image URLs.

Tips

1zoom_ratio of 1 makes a non-square image into a square without actually zooming out.
2Higher zoom ratios give Midjourney more creative freedom in the new border areas.
3Use the prompt to guide what appears in the expanded area.
4The parent_task_id must be from /upscale-1x. Zoom Out is only available on upscaled images, not grids.

Quirks & Gotchas

The task_type is always "outpaint-2" regardless of the zoom_ratio you specify.

Only zoom_ratio values of 1, 1.5, and 2 are officially supported. Other values may not work correctly.

Passing a grid task ID (from /imagine or /reroll) as the parent will fail. You must upscale with /upscale-1x first.

Expert Tips & Best Practices

Adapting images for different social media formats

A common workflow: generate a portrait (9:16) for Instagram Stories, then outpaint at 2x with aspect_ratio 16:9 to create a widescreen version for Twitter/YouTube thumbnails. This gives you a consistent scene across multiple formats without regenerating. Prompt the outpaint with scene context so the expanded areas feel natural.

Building scenes outward from a focal point

When you have a tightly framed subject (a portrait, a product shot), outpaint to reveal the environment around it. Start with 1.5x zoom to establish the immediate surroundings, then outpaint again at 1.5x for wider context. Each outpaint builds on the previous, so you can progressively reveal a larger scene while keeping the original focal point intact.

Related Endpoints

POST/inpaint POST/pan