Recraft V4 API

Recraft V4: brand-consistent illustrations, icons and design assets.

Recraft·ImageAvailable

from$0.036/ image~~$0.04~~10% off

Model IDrecraft-v4

Try in Playground View API

text-to-imagedesign

Input

Text

Output

Image

Provider

4 providers

Aspect ratio

1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3

Last 7 days · not enough recent requests for stats yet.

Recraft V4 pricing

Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.

Option	Price (USD)
All options	$0.036 / image 4 Credits~~$0.04~~10% off

Try Recraft V4 before you integrate

Test output quality, compare provider prices and estimate cost before writing any code.

Provider

Image

Estimated cost

Input

Prompt*prompt

Aspect ratioaspect_ratio

Result

Idle

Your generation will appear here.

Provider prices for this request

Enter a prompt to compare provider prices.

Recraft V4 prompt examples

Ready-to-use prompts. Load one into the playground and tweak it.

Source

Scene

20 prompts

A young woman sitting in a Parisian café at golden hour, soft bokeh background, shot o

A young woman sitting in a Parisian café at golden hour, soft bokeh background, shot on Canon EOS R5, 85mm f/1.4, natural lighting, film grain

A frosted glass perfume bottle on a slab of raw marble, surrounded by scattered white

A frosted glass perfume bottle on a slab of raw marble, surrounded by scattered white peonies and morning dew drops, soft diffused studio lighting from above, product photography, clean white background, 4K

A samurai standing in a field of luminous blue flowers under a crescent moon, his armo

A samurai standing in a field of luminous blue flowers under a crescent moon, his armor covered in frost, a spectral white fox sitting beside him, Japanese ink wash meets digital painting

Giant inflatable balloon letters spelling 'Recraft V4' floating above a surreal pink d

Giant inflatable balloon letters spelling 'Recraft V4' floating above a surreal pink desert landscape, the letters are shiny chrome with candy-colored reflections, cotton candy clouds in a vivid sunset sky, dreamlike atmosphere

Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, color

Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, colorful boats in the harbor appearing toy-like, selective focus band across the middle, saturated primary colors of blue red and yellow boats against white buildings, 90mm tilt-shift lens, the familiar made fantastical, Wes Anderson color sensibility

A ceramic coffee mug on a wooden table with the text 'Good Morning' written in elegant

A ceramic coffee mug on a wooden table with the text 'Good Morning' written in elegant hand-lettered script, warm morning light streaming through a window, shallow depth of field, lifestyle photography

Recraft V4 API reference

Endpoints, request fields and runnable examples for this model.

Base URL

https://01router.com/api/v1

llms.txt

Quick start

Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.

Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "recraft-v4",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

Endpoints

Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.

POST

/api/v1/generations

Create a generation (charges credits) · API key required

GET

/api/v1/generations/{id}

Get a generation; polls the provider while running · API key required

POST

/api/v1/generations/{id}/cancel

Cancel a running generation (credits refunded) · API key required

POST

/api/v1/quote

Price a request on every provider (no charge, no key needed) · Public · no key

POST

/api/v1/images/generations

OpenAI-compatible image generation (waits for the result) · API key required

GET

/api/v1/models/recraft-v4

Get one model · Public · no key

Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Get an API key

Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

Request body

Name	Type	Required	Description
model	string	Yes	"recraft-v4"
provider	string	No	Pin a provider; omit to auto-route to the cheapest. One of: fal \| replicate \| wavespeed \| vercel
input	object	Yes	Model parameters, see the input fields below.
callback_url	string	No	Optional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available.

input · input fields

Required fields are marked explicitly. Other fields use the listed defaults when omitted.

Name	Type	Required	Values	Default
prompt*	string	Yes	—	—
aspect_ratio	string	No	1:1 \| 16:9 \| 9:16 \| 4:3 \| 3:4 \| 3:2 \| 2:3	1:1

Callbacks →

Output

Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.

queued→processing→succeeded / failed

Task submitted

{
  "id": "gen_example",
  "object": "generation",
  "model": "recraft-v4",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

Task completed

{
  "id": "gen_example",
  "object": "generation",
  "model": "recraft-v4",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  },
  "outputs": [
    "https://example.com/output.png"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Response fields

Name	Type	Required	Description
id	string	Yes	Generation ID. Use it to query or cancel this task.
object	string	Yes	generation
model	string	Yes	recraft-v4
type	string	Yes	image
provider	string	Yes	Provider
status	string	Yes	queued → processing → succeeded / failed. Stop polling at either terminal state.
input	object	Yes	Model parameters, see the input fields below.
outputs	string[]	Yes	Result URLs. Empty while processing; read after succeeded and save the files promptly.
error	string \| null	Yes	Failure reason, or null when no failure is reported.
credits	number	Yes	Credits charged for this request.
price_usd	number	Yes	Request price in USD.
created_at	string	Yes	Creation time in ISO 8601 format.
completed_at	string \| null	Yes	Completion time in ISO 8601 format; null before completion.

Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.

Cancel a task

Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Quote

Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "recraft-v4",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  }
}
JSON

OpenAI-compatible images

For OpenAI SDK integrations, use this endpoint with top-level prompt. It waits for the result and returns data[].url. For asynchronous tasks and the full model parameter set, use /generations.

curl "https://01router.com/api/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "recraft-v4",
  "prompt": "A cinematic shot of a red fox running through snow"
}
JSON

{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/output.png"
    }
  ]
}

Model schema

This public endpoint returns the model parameters and each provider’s supported constraints and prices.

curl "https://01router.com/api/v1/models/recraft-v4"

Errors

Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400Invalid body or parameter value

401Missing or invalid API key

402Not enough credits

404Unknown model or generation

409The task cannot be canceled (already finished, or the provider does not support canceling)

429Too many requests — retry after the given seconds

502Every provider rejected the task (credits refunded)

Auth, routing, billing and error codes are covered in →

Use with AI

Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.

Open llms.txt

How does Recraft V4 compare?

Specs and starting prices side by side. Test with the same prompt before you choose.

	Recraft V4	GPT Image 2.5 Flare	GPT Image 2.5 Sunburst	Nano Banana 2.1
Vendor	Recraft	OpenAI	OpenAI	Google
Starting price	$0.036 / image	$0.0053 / image	$0.0053 / image	$0.018 / image
Input	Text	Text · Image	Text · Image	Text · Image
Provider	4 providers	6 providers	6 providers	8 providers
Aspect ratio	1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3	1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3	1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3	1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9

Recraft V4 API FAQ

What makes Recraft V4 different?

Recraft V4 was built with designers around composition, lighting and materials, so results feel art-directed. Text is rendered as part of the design.

Does this model output vectors?

This endpoint returns raster images. Recraft's vector (SVG) models are separate products.

Which aspect ratios are supported?

1:1, 16:9, 9:16, 4:3, 3:4, 3:2 and 2:3.

What is it good for?

Marketing visuals, product and editorial images, posters, packaging, social media assets and concept art.

How is it billed on 01router?

A flat price per generated image; see the pricing table. Failed generations are refunded.

Related models

Other models you can call with the same API key.

Image · OpenAI

GPT Image 2.5 Flare

OpenAI GPT Image 2.5 Flare: fast everyday generation and editing with precise text rendering.

from $0.0053 / imageView API

Image · OpenAI

GPT Image 2.5 Sunburst

OpenAI GPT Image 2.5 Sunburst: tighter control for demanding edits and premium creative.

from $0.0053 / imageView API

Image · Google

Nano Banana 2.1

Google Gemini image model: consistent multi-reference editing, 1K–4K output.

from $0.018 / imageView API

Image · ByteDance

Seedream 5.0 Pro

ByteDance Seedream 5.0 Pro: photoreal images, multilingual text and up to 10-reference editing.

from $0.026 / imageView API

Image · Google

Nano Banana 2

Gemini 3.1 Flash Image: fast generation and editing with strong text rendering, 1K–4K.

from $0.036 / imageView API

Image · ByteDance

Seedream 5.0 Flash

Low-latency Seedream 5.0: same price for 1K–2K, up to 10 reference images.

from $0.012 / imageView API