Image
Image Generation
Generate images from text prompts using 30+ models across 9 families — all through the single /imagine endpoint. Switch models by changing one field.
Sync vs Async models
Synchronous
Most models (Flux 2, Seedream, GPT-Image, Ideogram, Grok, Nano Banana, Recraft, Qwen, Z-Image) complete in a single call. Your first /fetch returns status: "finished" immediately.
Asynchronous
Midjourney and Flux 1 (Pro/Dev/Schnell) are async. The API returns a task_id immediately. Poll with /fetch or use a webhook for the result.
Model families
| Family | Description | Cost | Mode |
|---|---|---|---|
| Midjourney | Best-in-class artistic quality. Returns a 2×2 grid you refine with upscale, variations, and editing operations. | 4 cr | Async |
| Flux 2 (Dev/Flex/Max) | Fast synchronous generation. Flux.2 Dev at 1 credit is the best bang-for-buck model for high-volume pipelines. | 1–4 cr | Sync |
| Flux Kontext | Context-aware image editing. Provide a reference image and a text instruction to modify it precisely. | 4–8 cr | Sync |
| Seedream | ByteDance image models with strong Chinese-language prompt support. Includes SeedEdit for image editing. | 2–3 cr | Sync |
| GPT-Image / GPT-4o Image | OpenAI image API. Excellent at following detailed instructions and rendering legible text inside images. | 2–3 cr | Sync |
| Ideogram v3 | Strong typography and graphic design output. Includes Edit, Remix, and Reframe variants. | 5 cr | Sync |
| Nano Banana | Google Imagen family. High throughput synchronous generation. | 2–3 cr | Sync |
| Grok Image | xAI image models. Stylistically distinct output. | 3–4 cr | Sync |
| Flux 1 (Pro/Dev/Schnell) | Black Forest Labs original Flux series. Asynchronous with BFL direct API polling. | 1–4 cr | Async |
Quick start
# Synchronous — result ready immediately
curl -X POST https://journeyapi.co/api/v1/imagine \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-dev",
"prompt": "a red fox in a snowy forest, cinematic",
"aspect_ratio": "16:9"
}'
# Midjourney (async) — poll /fetch for the result
curl -X POST https://journeyapi.co/api/v1/imagine \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a red fox in a snowy forest --ar 16:9",
"webhook_url": "https://your-server.com/webhook"
}'