journeyapi.dev

POST/v1/images

The only generation endpoint. What it does depends on what you give it: a prompt alone generates from text, a prompt plus reference images generates against them, and images alone with a high strength produces variations of what you supplied.

To do this	Send
Generate from text	prompt
Generate against references	prompt and images
Vary an image you have	images with image_strength above 0.8
Combine several sources	two to five images

Body

promptstring: The text prompt, up to 6000 characters. Required unless images is given.
imagesarray: One to five references, each an image id from a finished job or a publicly reachable URL. Required unless prompt is given.
image_strengthnumber: How closely to follow the references, 0 to 1. Defaults to 0.5. Above 0.8 stays near the source and reads as a variation; below 0.3 treats it as loose inspiration.
negative_promptstring: Concepts to steer away from.
ninteger: How many images to generate, 1 to 4. Defaults to 1. Each is billed separately.
aspect_ratiostring: Width to height, such as 1:1, 3:2, 16:9 or 9:16. Defaults to 1:1.
style_strengthinteger: How much aesthetic interpretation to apply, 0 to 100. Low reads the prompt literally. Defaults to 30.
detailstring: draft, standard (default) or high. Higher settings cost proportionally more.
seedinteger: Fixes the starting noise so a prompt reproduces. Random when omitted, and always returned on the job.
seamlessboolean: Produce an image that tiles without a visible seam.
modelstring: image-2 (default), image-2-lite for a cheaper faster render, or illustration-1 for drawn and stylised work.
prioritystring: standard (default) or batch. Batch costs a quarter and carries no concurrency guarantee.
webhook_urlstring: Overrides the account webhook for this job only.
metadataobject: Up to 16 key-value pairs echoed back on the job, for correlating with your own records.

From text

curl -X POST https://api.journeyapi.dev/v1/images \
  -H "Authorization: Bearer $JOURNEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f1c2a90-4d3b-4e18-9a55-1c0f8e2b6d44" \
  -d '{
    "prompt": "a lighthouse on a basalt cliff, fog, long exposure",
    "aspect_ratio": "3:2",
    "n": 2
  }'

From a reference

curl -X POST https://api.journeyapi.dev/v1/images \
  -H "Authorization: Bearer $JOURNEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "the same lighthouse at dawn, clear air",
    "images": ["img_01HQ8VZ4T2B7MC"],
    "image_strength": 0.6
  }'

As a variation

curl -X POST https://api.journeyapi.dev/v1/images \
  -H "Authorization: Bearer $JOURNEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "images": ["img_01HQ8VZ4T2B7MC"], "image_strength": 0.9, "n": 4 }'

Response · 202 Accepted

{
  "id": "job_01HQ8VZ3K9XM2P",
  "object": "job",
  "type": "image",
  "status": "queued",
  "progress": 0,
  "model": "image-2",
  "prompt": "a lighthouse on a basalt cliff, fog, long exposure",
  "cost_usd": 0.10,
  "created_at": "2026-09-18T09:14:02Z",
  "completed_at": null
}

Generate images

Body