🎨Image APIActive

recraft-v4 API

Generate design-focused images with the Recraft V4 API via API in One. 4 sub-models for raster and vector output, standard and pro quality. 10–70 credits per image.

Get API Key View Docs

Model IDrecraft-v4

Use this in the request body model field.

Endpoint/api/v1/images/generations

The currently implemented BFF route.

Outputimage

Input types: text

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookNot required

This route does not require webhook handling.

Live capabilities

These capabilities come from the current model config and backend route. Unreleased APIs are not listed.

Vector (SVG) output support

4 quality tiers for different needs

Design

Design-focused with style control

Brand

Brand-consistent output

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/images/generations10 credits

Recraft V4 — design-focused AI image generation with style control, vector output, and brand-consistent results.

Parameters

promptstring

Text description of the image

Required

modelstring

Sub-model: "recraft-v4-text-to-image" (10cr), "recraft-v4-text-to-vector" (20cr), "recraft-v4-pro-text-to-image" (60cr), "recraft-v4-pro-text-to-vector" (70cr)

Optional · Default recraft-v4-text-to-image

image_sizestring

Image dimensions (e.g. "1024x1024")

Optional · Default 1024x1024

Example request

curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "recraft-v4-text-to-image",
  "prompt": "A minimalist line art illustration of a mountain landscape, clean design",
  "image_size": "1024x1024"
}'

Models on the same endpoint

These live models use the same implemented BFF endpoint and can be switched by changing the model field.

🧠cogview-4image · 4 credits/api/v1/images/generations

flux-2image · 5 credits/api/v1/images/generations

grok-imagineimage · 5 credits/api/v1/images/generations

kling-image-o1image · 6 credits/api/v1/images/generations✦ideogram-v3image · 8 credits/api/v1/images/generations🌐imagen-4image · 8 credits/api/v1/images/generations

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/generations

Poll task status

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

Task status route

After creating image, video, audio, or tool tasks, poll the real task endpoint for results.

GET/api/v1/tasks/{task_id}Check generation task status and result.

Pricing

10–70 credits per image (~$0.10–$0.70)

Base cost$0.10

Credits10

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

Generate brand-consistent marketing assets

Create icon sets and UI illustrations

Produce design mockups and concept art

Build AI design tools with style control

FAQ

How much does Recraft V4 cost?

Depends on sub-model: recraft-v4-text-to-image (10cr), recraft-v4-text-to-vector (20cr), recraft-v4-pro-text-to-image (60cr), and recraft-v4-pro-text-to-vector (70cr).

What makes Recraft V4 different?

Recraft V4 is specifically designed for design workflows. It supports both raster and vector (SVG) output with standard and pro quality tiers.

Can I generate vector images?

Yes. Use recraft-v4-text-to-vector or recraft-v4-pro-text-to-vector to generate vector (SVG) output.