🎨

Recraft V4 API

active

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

Recraftimage10 credits/call
Provider
Recraft
Pricing
10–70 credits per image (~$0.02–$0.14)
Speed
3–8 seconds
Output
image

Quick Start

Send a request to the Recraft V4 API:

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

API Endpoint

POST/api/v1/images/generations
Send a POST request with your API key to generate content using Recraft V4.

Headers

HeaderТипОбязательноОписание
AuthorizationstringОбязательноBearer YOUR_API_KEY
Content-TypestringОбязательноapplication/json

Body Parameters

ПараметрТипОбязательноОписание
modelstringОбязательноModel identifier: "recraft-v4"
promptstringОбязательноText description of the image
modelstringНеобязательноSub-model: "recraft-v4-text-to-image" (10cr), "recraft-v4-text-to-vector" (20cr), "recraft-v4-text-to-image-pro" (60cr), "recraft-v4-text-to-vector-pro" (70cr) (По умолчанию: recraft-v4-text-to-image)
image_sizestringНеобязательноImage dimensions (e.g. "1024x1024") (По умолчанию: 1024x1024)

Example Request

json
{
  "model": "recraft-v4-text-to-image",
  "prompt": "A minimalist line art illustration of a mountain landscape, clean design",
  "image_size": "1024x1024"
}

Example Response

Successful task creation response.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n78xxxx_recraft",
    "status": "IN_PROGRESS"
  }
}

Check Task Status

For asynchronous tasks, poll the status endpoint to check when your task is complete:

GET/api/v1/tasks/{task_id}
Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.
bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

Use Cases

  • Generate brand-consistent marketing assets
  • Create icon sets and UI illustrations
  • Produce design mockups and concept art
  • Build AI design tools with style control

API Tester

Test the Recraft V4 API directly from your browser:

Песочница APIPOST

Error Codes

{
  "error": {
    "code": 400,
    "message": "Invalid parameters",
    "type": "invalid_request"
  }
}

Frequently Asked Questions

How much does Recraft V4 cost?

Depends on sub-model: text-to-image (10cr), text-to-vector (20cr), text-to-image-pro (60cr), text-to-vector-pro (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 the text-to-vector or text-to-vector-pro sub-model to generate vector (SVG) output.

Why Use Recraft V4 Through API in One?

1Vector (SVG) output support
24 quality tiers for different needs
3Design-focused with style control
4Brand-consistent output

Ready to use Recraft V4?

Get Your API Key →