Recraft V4 API
activeRecraft V4 — design-focused AI image generation with style control, vector output, and brand-consistent results.
Quick Start
Send a request to the Recraft V4 API:
| 1 | curl -X POST https://apiin.one/api/v1/images/generations \ |
| 2 | -H "Authorization: Bearer YOUR_API_KEY" \ |
| 3 | -H "Content-Type: application/json" \ |
| 4 | -d '{ |
| 5 | "model": "recraft-v4-text-to-image", |
| 6 | "prompt": "A minimalist line art illustration of a mountain landscape, clean design", |
| 7 | "image_size": "1024x1024" |
| 8 | }' |
API Endpoint
/api/v1/images/generationsSend a POST request with your API key to generate content using Recraft V4.
Headers
Bearer YOUR_API_KEY
application/json
Body Parameters
Model identifier: recraft-v4
Text description of the image
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) Defaults to recraft-v4-text-to-image.
Image dimensions (e.g. 1024x1024) Defaults to 1024x1024.
Example Request
| 1 | { |
| 2 | "model": "recraft-v4-text-to-image", |
| 3 | "prompt": "A minimalist line art illustration of a mountain landscape, clean design", |
| 4 | "image_size": "1024x1024" |
| 5 | } |
Example Response
Successful task creation response.
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n78xxxx_recraft", |
| 6 | "status": "IN_PROGRESS" |
| 7 | } |
| 8 | } |
Check Task Status
For asynchronous tasks, poll the status endpoint to check when your task is complete:
/api/v1/tasks/{task_id}Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.
| 1 | curl https://apiin.one/api/v1/tasks/task_abc123 \ |
| 2 | -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:
Error Codes
| 1 | { |
| 2 | "error": { |
| 3 | "code": 400, |
| 4 | "message": "Invalid parameters", |
| 5 | "type": "invalid_request" |
| 6 | } |
| 7 | } |
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?
Ready to use Recraft V4?
Get Your API Key →