Image Generation

Kyma serves nine image-generation models behind a single async endpoint. Pick the right model for the output you need; the API shape is identical across all of them.

curl -X POST https://kymaapi.com/v1/images/generations \
  -H "Authorization: Bearer $KYMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "recraft-v4", "prompt": "a cinematic hourglass on a wooden desk, golden hour" }'

The endpoint is asynchronous. POST returns 202 with a job_id immediately; poll GET /v1/jobs/{job_id} until status is succeeded.

Pick a model

Model	Best for	Cost	Input
`recraft-v4`	Default — design-quality, brand assets, illustration	$0.054	text
`recraft-v4-pro`	Print-ready 4MP design	$0.338	text
`recraft-v4-vector`	Native SVG — logos, icons, illustration	$0.108	text
`flux-2-pro`	Photoreal, multi-reference blend, gen+edit	$0.041–$ 0.101	text + image(s)
`flux-kontext-pro`	Image edit — inpaint, refine, modify	$0.054	text + image
`ideogram-v3`	Typography, logos, posters, packaging	$0.081	text
`gpt-image-2`	Text-in-image (multilingual), reasoning composition	$0.009–$ 0.285 (per quality)	text + image
`gpt-image-2.5-flare`	Consistent characters from references, exact text-in-image	$0.009–$ 0.285 (per quality)	text + image
`minimax-image-01`	Cheapest tier, sub-cent budget	$0.005	text
`nano-banana-3-flash`	Edit-mode — image-in + prompt → image-out (Gemini 3.1)	$0.061	text + image
`recraft-v4-vector-pro`	Paused. Use `recraft-v4-vector` instead.	—	text
`flux-1.1-ultra`	Paused. Use `flux-2-pro` instead.	—	text
`recraft-v3`	Paused. Use `recraft-v4` instead.	—	text

See pricing, or GET /v1/pricing for the live canonical source.

recraft-v4

Top of HuggingFace Text-to-Image Arena (#1) — beats Midjourney V8, DALL-E 3, and FLUX in human preference evaluation. Design-aware composition, lighting, and material rendering.

{
  "model": "recraft-v4",
  "prompt": "isometric vector illustration of a cloud server rack, blue and gold accent",
  "size": "1:1"
}

Cost: $0.054 per image
Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9
n: up to 4 images per request
Best for: brand illustration, marketing visuals, design-quality default

recraft-v4-pro

Recraft V4 at 4 megapixels for print-ready or large-scale assets — same design taste as V4 standard, higher resolution.

{
  "model": "recraft-v4-pro",
  "prompt": "minimalist coffee bag label, cream background, gold foil typography"
}

Cost: $0.338 per image
Output: up to 4 megapixels
Best for: print, posters, hero campaign visuals, large displays

recraft-v4-vector

Native SVG output — actual paths and structured layers, editable in Figma, Illustrator, or any vector editor. The only generation model on the market shipping true vector files (every other model rasterises and lies about it).

{
  "model": "recraft-v4-vector",
  "prompt": "minimalist tech brand mark, abstract wave forming a Greek psi symbol, gold on navy"
}

Cost: $0.108 per image
Output: SVG file (Content-Type: image/svg+xml)
Best for: logos, icons, illustration sets, brand systems that need to scale

recraft-v4-vector-pro

Paused as of 12 September 2026. A request returns 404 model_not_found and names recraft-v4-vector as the replacement.

flux-2-pro

BFL’s 32B flagship released November 2025 — 3× larger than Flux 1.1, wins ~2/3 of blind comparisons against the prior generation, ~60% accurate text-in-image. Unifies generation and editing in one model. Single-reference (image-to-image edit):

{
  "model": "flux-2-pro",
  "prompt": "make the sky a stormy sunset",
  "image_url": "https://example.com/source.jpg",
  "size": "16:9"
}

Multi-reference blend (up to 10 sources, FLUX.2 Pro’s signature feature):

{
  "model": "flux-2-pro",
  "prompt": "blend these three style references into one cohesive scene",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg",
    "https://example.com/ref3.jpg"
  ],
  "size": "16:9"
}

The first 6 reference images receive high-fidelity processing; references 7–10 act as supplementary composition guides. Beyond 10 returns 400 too_many_references. Text-only is also fully supported — no reference required.

Cost: per megapixel of output, rounded to nearest whole MP — a flat price for the first MP plus a per-extra-MP rate (see GET /v1/pricing for current rates).
- 1024×1024 → 1 MP → $0.041
- 1920×1080 → 2 MP → $0.061
- 2048×2048 → 4 MP → $0.101
Best for: photorealism, multi-source blending, hero shots, unified gen/edit workflows

flux-kontext-pro

Image-to-image editor. Takes an existing image plus a text instruction; returns a modified image. Use for inpainting, prop swaps, background changes, refinement.

{
  "model": "flux-kontext-pro",
  "prompt": "replace the sky with a stormy sunset",
  "image_url": "https://example.com/source.jpg"
}

Cost: $0.054 per image
Requires: image_url (HTTPS URL to the source image). A request without image_url returns 400 image_url_required.

ideogram-v3

Text-in-image specialist. Best model on Kyma for typography, packaging mockups, posters, and logos where readable, accurate text matters.

{
  "model": "ideogram-v3",
  "prompt": "minimalist coffee bag label that reads 'KYMA ROAST', cream background, gold foil"
}

Cost: $0.081 per image
Strengths: legible text, brand-safe layouts, packaging design

flux-1.1-ultra

Paused as of 12 September 2026. A request returns 404 model_not_found and names flux-2-pro as the replacement.

recraft-v3

Paused as of 12 September 2026. A request returns 404 model_not_found and names recraft-v4 as the replacement.

Billing flow

POST creates a job and places a hold for estimated_cost (list price × n images; or per-MP estimate for FLUX.2 Pro based on requested size).
On succeeded, the hold is finalized as a usage transaction at the actual cost. For FLUX.2 Pro, the actual cost reflects the true output dimensions returned by the provider.
On failed or expired, the hold is fully refunded — you only pay for images you receive.

You can verify the charge on GET /v1/jobs/{id}: charged_amount is the final billed amount, estimated_cost is what was held up front.

Idempotency

Pass idempotency_key to make POST safe to retry. The same (user_id, idempotency_key) pair always returns the same job — no duplicate charges, no duplicate generations.

{
  "model": "recraft-v4",
  "prompt": "...",
  "idempotency_key": "checkout-flow-card-3"
}

Models

Pick a model

recraft-v4

recraft-v4-pro

recraft-v4-vector

recraft-v4-vector-pro

flux-2-pro

flux-kontext-pro

ideogram-v3

flux-1.1-ultra

recraft-v3

Billing flow

Idempotency

See also

​Pick a model

​recraft-v4

​recraft-v4-pro

​recraft-v4-vector

​recraft-v4-vector-pro

​flux-2-pro

​flux-kontext-pro

​ideogram-v3

​flux-1.1-ultra

​recraft-v3

​Billing flow

​Idempotency

​See also

Pick a model

recraft-v4

recraft-v4-pro

recraft-v4-vector

recraft-v4-vector-pro

flux-2-pro

flux-kontext-pro

ideogram-v3

flux-1.1-ultra

recraft-v3

Billing flow

Idempotency

See also