Documentation

API Documentation

Everything you need to integrate JourneyAPI into your application. One API key, one consistent interface across all AI models.

Quick Start

1. Get your API key

2. Make your first request

curl -X POST https://api.journeyapi.com/api/v1/imagine \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a sunset over mountains", "model": "flux-pro", "aspect_ratio": "16:9"}'

3. Get the result

Poll with /fetch or set up a webhook to receive results automatically.

Base URL

https://api.journeyapi.com/api/v1

All Endpoints

Method	Endpoint	Description	Credits
POST	/imagine	Generate images from a text prompt.	1-8
POST	/reroll	Re-run a generation with the same or tweaked prompt, producing an entirely new 2×2 grid.MJ	4
POST	/upscale-1x	Select one of the four grid images and upscale it to a full-resolution single image.MJ	2
POST	/upscale-alt	Apply a second-pass enhancement to an already-upscaled Midjourney image.MJ	4
POST	/upscale-2x-4x	Multiply an image's pixel dimensions by 2x or 4x using AI upscaling.MJ	2
POST	/variations	Generate a new 2×2 grid of variations from an existing image.MJ	4
POST	/inpaint	Regenerate a specific region of an upscaled Midjourney image while keeping the rest intact.MJ	4
POST	/outpaint	Expand an upscaled Midjourney image outward, generating new content around the edges to create a wider scene.MJ	4
POST	/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.MJ	4
POST	/blend	Merge 2–5 images together using Midjourney's blend algorithm, which combines their visual concepts, styles, colors, and compositions into a new 2×2 grid.MJ	4
POST	/describe	Reverse-engineer Midjourney prompts from any image.MJ	2
POST	/shorten	Analyze a long Midjourney prompt and identify which tokens carry the most weight.MJ	2
POST	/seed	Retrieve the numeric seed used for a completed Midjourney generation.MJ	2
POST	/faceswap	Replace a face in a target image with a face from a source image.	2
POST	/imagine-video	Generate a short animated video clip from a start frame image and a motion prompt.	8
POST	/extend-video	Continue a video generated by /imagine-video with additional frames, extending the clip's duration.	8
POST	/fetch	Get the current status and result of a task.	Free
POST	/fetch-many	Get the status and results of multiple tasks in a single request.	Free
GET	/account	Get your account information including email, credit balance, usage stats, and current plan.	Free

Next Steps

Authentication

How to authenticate your API requests.

Task Lifecycle

Understand task statuses and transitions.

Webhooks

Receive results via webhook instead of polling.

POST /imagine

Start generating images with the primary endpoint.