recraft/4.0/style/pro/text-to-image
4.0 Style Pro is Recraft's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runrecraft/4.0/style/pro/text-to-imageInput Schema
7 parameters · 1 required · 6 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | Min length: 1 · Max length: 10000 |
colors | object[] | Optional | An array of preferable colors · Default: [] |
images | string[] | Optional | The URLs of the style reference images. Supports PNG, JPG, and WEBP; provide between 1 and 10 images. |
style_id | string | Optional | The ID of an existing V4 custom style. |
style_match | string | Optional | Override how closely the generation follows the custom style. · Options: precise, flexible preciseflexible |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
background_color | string | Optional | The preferable background color of the generated images. |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "recraft/4.0/style/pro/text-to-image",
"colors": [],
"prompt": "Crash zoom frozen at the moment of impact as a kingfisher breaks the surface of a pond"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Recraft V4 Style Pro Text to Image
Recraft V4 Style Pro Text to Image is the Recraft V4 route for styled text-to-image generation, turning a text prompt and optional reusable style into a production-ready result while keeping the operation distinct from neighboring endpoints. 4.0 Style Pro is Recraft's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence. The workflow is designed for creators who need the model’s specific transformation to remain visible in the request, so the source, intended change, and finished artifact can be reviewed as one coherent creative decision.
In practical use, this route exposes background_color, colors, enable_safety_checker, image_size, image_urls, prompt, safety_tolerance, style_id to shape the exact deliverable. Those controls let a team preserve the important source constraints, state subject behavior or material treatment precisely, choose supported timing or output characteristics, and reproduce successful settings across alternate takes. The result fits an iterative pipeline: establish the core brief, compare controlled variations, then pass the selected asset into editorial, design, localization, visualization, or publishing work.
Highlights
- Style-conditioned creation. Generate a new image from text while applying an existing style identifier when one is available.
- Style creation fallback. Create the needed visual style as part of the request when no reusable style identifier is supplied.
- Pro image rendering. Use the Pro route for polished typography, composition, texture, and campaign-grade finish.
- Reusable art direction. Keep a style identifier stable across prompts to build a coherent visual series.
Pricing
| Configuration | Price |
|---|---|
| Existing style ID | $0.115000 |
| No style ID; includes style creation | $0.121000 |
When to Use
| Scenario | Why it fits |
|---|---|
| Exact workflow fit | Choose this route when the required deliverable is styled text-to-image generation, rather than a related route with different source media. |
| Directed creative iteration | Use it when subject, motion, material, speech, framing, or finish should be expressed explicitly and compared across controlled variants. |
| Existing-asset continuity | Use it when supplied images, video, audio, references, or styles must remain the anchor for the generated result. |
| Repeatable production | Use it when successful inputs need to be saved and rerun across a campaign, asset set, localization pass, or batch. |
| Pipeline handoff | Use it when the returned artifact will move into editorial, compositing, visualization, review, storage, or publishing. |
Prompt Guide
Start with the source or subject, then describe the intended transformation, movement or behavior, camera and composition, and the desired finish. Keep media URLs reachable, use only fields documented for this exact route, and change one major control at a time when comparing results. For source-led tasks, describe what should change as well as what must remain recognizable.
{
"prompt": "A cinematic close shot with clear subject action, camera movement, lighting, and final visual treatment."
}
Technical Specs
| Property | Value |
|---|---|
| Model ID | recraft/4.0/style/pro/text-to-image |
| Execution mode | async |
| Required inputs | prompt |
background_color | string |
colors | array; default: [] |
enable_safety_checker | boolean; default: false |
image_size | string |
image_urls | array |
prompt | string |
safety_tolerance | string; default: 6 |
style_id | string |
style_match | string |
sync_mode | boolean; default: false |
Related Models
recraft/4.0/style/pro/text-to-vectorrecraft/4.0/style/text-to-imagerecraft/4.0/style/text-to-vectorrecraft/recraft/v4.1/pro/vector