POST/pan4 creditsMidjourney only

Pan

Extend an upscaled Midjourney image in one direction (up, down, left, right), revealing new content on that edge while the original image shifts to the opposite side. Unlike outpaint which expands around all edges, pan moves the camera in a single direction, making it ideal for building panoramic scenes, scroll-through compositions, or extending a scene naturally. 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 pan from.
direction	`string`	Required	Direction to pan. New content is generated on the side you pan toward. `updownleftright`
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/pan \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_task_id": "772a0622-a41d-63f6-c938-668877662222",
    "direction": "left",
    "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": "dd8g6c88-g07j-29l2-i594-224433228888"
}

Response Fields

Field	Type	Description
task_id	`string`	UUID of the pan task.
task_type	`string`	"pan-{direction}" (e.g., "pan-left").
original_image_url	`string`	URL of the new grid.
image_urls	`string[]`	Array of 4 individual image URLs.

Tips

1Pan "left" means the image viewport moves left, generating new content on the left edge.
2You can chain multiple pans to create panoramic images.
3The parent_task_id must be from /upscale-1x. Pan is only available on upscaled images, not grids.

Quirks & Gotchas

Pan only works with images that have already been upscaled via /upscale-1x. Passing a grid task ID will fail.

The direction field controls the pan — there is no index parameter. One pan = one direction.

Expert Tips & Best Practices

Building panoramic compositions

Chain multiple left/right pans to build a wide panoramic scene. After each pan, take the result grid, upscale the best image, and pan again. This incrementally extends the scene in one direction. For landscape panoramas, pan left and right from a centered starting image to build the full width. For architectural or nature shots, this creates believable wide-format images.

Vertical scroll content

Use up/down pans to create vertically scrollable content — for mobile backgrounds, long-format social content, or scrolling game backgrounds. Start with a tall scene and pan downward to reveal what's below. Pan direction is relative to the viewport, so "down" extends the bottom of the image and shifts the existing content up.

Related Endpoints

POST/outpaint POST/inpaint