POST/api/v1/imagine4 creditsAsynchronous

Midjourney

Provider · MidjourneyType · T2IModel ID · midjourneyUpstream ID · midjourney (via /mj/submit/imagine)

Midjourney — the gold standard for artistic image generation. Returns a 2×2 grid of four image candidates which you refine using the upscale, variation, inpaint, outpaint, and pan endpoints. Asynchronous — returns task_id immediately and requires polling or a webhook for results.

Request Parameters

Parameter	Type	Required	Description
prompt	`string`	Required	The text prompt describing the image to generate.
model	`string`	Optional	Set to `midjourney` to use this model.Default: `midjourney`
aspect_ratio	`string`	Optional	Output aspect ratio. Allowed: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3.Default: `1:1`
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 for verification.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/imagine \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a majestic elk in a misty forest at dawn, photorealistic --ar 16:9",
    "webhook_url": "https://your-server.com/webhook"
  }'

Immediate Response

Returns immediately with a task ID. Poll /fetch or set a webhook_url to receive the result.

200 OK

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}

Tips

1Use Midjourney parameters in the prompt string: --ar for aspect ratio, --sref for style reference, --chaos for variety.
2After you receive the grid, use /upscale-1x on your preferred panel before using any editing endpoints.
3Set `webhook_url` to avoid polling — you'll be notified when the grid is ready.

Quirks & Gotchas

Asynchronous: unlike all other image models, Midjourney requires polling /fetch or a webhook to get results.

Returns a grid image (4 panels) — not a single image. Use /upscale-1x to extract an individual panel.