/upscale-1x2 creditsMidjourney onlyUpscale 1x
Select one of the four grid images and upscale it to a full-resolution single image. This is the required gateway step before you can use any editing or enhancement action — /variations (strong/subtle), /outpaint, /inpaint, /pan, and /upscale-alt all require an upscale-1x task as their parent. Equivalent to clicking U1–U4 in the Midjourney Discord. Midjourney only.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| parent_task_id | string | Required | Task ID of the parent /imagine, /reroll, or /variations task. |
| index | string | Required | Which image from the grid to upscale (1=top-left, 2=top-right, 3=bottom-left, 4=bottom-right).1234 |
| 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 -X POST https://api.journeyapi.com/api/v1/upscale-1x \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"parent_task_id": "550e8400-e29b-41d4-a716-446655440000",
"index": "2",
"webhook_url": "https://your-server.com/webhook"
}'Immediate Response
Returns immediately with a task ID. Use /fetch or webhooks to get the result.
{
"task_id": "772a0622-a41d-63f6-c938-668877662222"
}Response Fields
| Field | Type | Description |
|---|---|---|
| task_id | string | UUID of the upscale task. |
| task_type | string | Always "upscale#1". |
| image_url | string | URL of the single upscaled image. |
Tips
- 1After upscaling, you can further enhance the image with /upscale-alt (subtle or creative).
- 2The grid position numbering is: 1=top-left, 2=top-right, 3=bottom-left, 4=bottom-right.
Quirks & Gotchas
Index is 1-based in our API (1-4) but 0-based internally. Don't pass "0".
Returns a single image_url instead of image_urls array.
Expert Tips & Best Practices
How to pick the best grid image
Evaluate grid images on three criteria in order: (1) Composition — does the framing and subject placement feel right? This is hardest to fix later. (2) Focus and sharpness — is the main subject in focus? (3) Lighting and mood — does the light direction and atmosphere match your intent? Composition is the most important because /variations and /pan can refine details, but they cannot fix a fundamentally broken layout.
Upscale-1x unlocks all editing actions
Every editing endpoint (/inpaint, /outpaint, /pan, /variations strong/subtle, /upscale-alt) requires a /upscale-1x task as its parent_task_id. If you try to pass a grid task ID to any of these endpoints, you will get a 400 error. Always upscale before editing.