Palette
Brushwork
Light
01
Upload style references
Put 1–10 images in one style into image_urls: PNG, JPG or WEBP, each under 20 MB.
Recraft V4 Styles API draws new images in the style of 1–10 reference pictures, for illustration series, brand visuals and social posts. Try it online on HiAPI.
Provider: Recraft
Category: image generation
Endpoint: /v1/tasks
Status: Available
Cost: See live page pricing
Back to Models
Recraft V4 Styles
Newby RecraftImage
Recraft V4 Styles API draws new images in the style of 1–10 reference pictures, for illustration series, brand visuals and social posts. Try it online on HiAPI.
Pricing
Standard Usage
115 Credits/ image
Input
0 / 10000
More parameters
Generation settings
How closely the result follows the reference style: precise stays close to the references, flexible allows more variation. Defaults to flexible when omitted
Estimated cost115 Credits / imageper image
Upload a reference image to run
Output
Ready for generation
Configure your parameters and click "Run" to see the output here.
--
References and result
The example shows the full output and the original prompt; the two submitted style references appear in the article below.
Related image models
Choose an adjacent model by task, output tier, and reference-image needs.
Higher-resolution styled images
Recraft V4 Styles Pro
Same parameters with 2048×2048 output at square_hd, for posters and print.
Text-only generation
Recraft V4.1
Use it when you have no reference images and describe the look in the prompt.
Sharper upscaling
Recraft Crisp Upscale
Enlarge a finished image while keeping it close to the original.
Background removal
Recraft Remove Background
Cut the subject out to a transparent PNG after generating.
About Recraft V4 Styles
Recraft V4 Styles API draws new images in the style of 1–10 reference pictures, for illustration series, brand visuals and social posts. Try it online on HiAPI.
The Playground and API use the same model ID: recraft-v4-styles/text-to-image. The 1–10 references in image_urls set the style, the prompt describes the content, and each request returns one image.
- Provider
- Recraft
- Task
- Text-to-Image
- References
- 1–10 style references (required)
- Pricing
- View live pricing
Model specifications
Choose inputs and output settings for your creative goal with Recraft V4 Styles.
- Reference images
- 1–10 style references (required)
- Image size
- square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
- Style match
- flexible (default)precise
- Palette
- colors / background_color (API)
- Output
- 1 image
- Prompt length
- 1–10000 characters
- Pricing
- View live pricing
Final cost depends on the output tier and input add-ons. Check the live page price and task record for the final charge.
How to use Recraft V4 Styles
Choose the destination and aspect ratio before composing subject, scene, material, light, and text.
Up to 10
Subject
Scene
Size preset
02
Write the prompt and pick a size
Describe the subject and scene in prompt, choose one of the six image_size presets, and set style_match if needed.
Playground
POST /v1/tasks
03
Validate before integration
Confirm the look in the Playground, then call POST /v1/tasks with the same model ID and parameters.
API Quickstart
Copy a minimal request below. See Docs for parameters, callbacks, task retrieval, and errors.
- Endpoint
POST /v1/tasks- Model ID
recraft-v4-styles/text-to-image
cURL
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "recraft-v4-styles/text-to-image",
"input": {
"prompt": "A cozy corner café on a rainy street at dusk, a cat sitting in the window, no logos, no brand names",
"image_urls": [
"https://static.hiapi.ai/gallery/2026/10/1d68aea559e20871.png",
"https://static.hiapi.ai/gallery/2026/10/01be0ab874ba475e.png"
],
"image_size": "square_hd"
}
}'The create request immediately returns a taskId; image generation continues asynchronously.
STYLE-REFERENCE IMAGE GENERATION
Recraft V4 Styles sets a style from a few references and draws new scenes in it
Recraft V4 Styles separates style from content: the references in image_urls set the palette, brushwork and light, and the prompt says what this image should show. It suits sets of illustrations, posters and social graphics that need one consistent look.
1–10 style references6 size presetsTwo style_match modes1 image per request
Explore the model ↓
STYLE-REFERENCE IMAGE GENERATION
About Recraft V4 Styles
Each request returns one image. Pick one of six size presets (square_hd by default); style_match controls how closely it follows the references; colors and background_color can pin the palette through the API.
The example below is a real result from this model: two flat illustrations in warm orange and deep teal as references, and a prompt for a rainy corner café with a cat in the window. The result is a new scene that keeps the references' palette and light.
Preparing style references
The references decide the look, so choosing them matters more than a long prompt.
Use images in one style
References that share palette, brushwork and lighting give the clearest style. The two references in the example come from one set of flat orange-and-teal illustrations.
Leave the content to the prompt
In the example the references show an interior and a courtyard, while the result shows the café from the prompt. Put subject, scene and composition in the prompt; the references do not need to match the content.
Formats and sizes
PNG, JPG or WEBP, each under 20 MB and 64 MB in total, no SVG. In API requests pass publicly accessible http(s) URLs, up to 10 images.
How the references become a new scene
The two images on the left are the submitted style references; on the right is the full Recraft V4 Styles output.
2 references · square_hd
Two references and one prompt: a rainy corner café
One reference is a warm interior with a teapot and books, the other a view through a window onto a courtyard and a bicycle; both are flat illustrations in warm orange and deep teal with hard-edged shadows.
The prompt only asked for a cozy corner café on a rainy street at dusk with a cat in the window. The result shows a corner café with tall windows, a cat on the sill, pendant lamps and rain streaks, in the references' palette and lighting; the teapot and bicycle from the references do not appear.
- References
- 2 images
- Size preset
- square_hd
- Output
- 1024×1024 WebP
A cozy corner café on a rainy street at dusk, a cat sitting in the window, no logos, no brand names
Which one to use
Choose by whether you have style references and how much resolution you need.
| Aspect | Recraft V4 Styles | Recraft V4 Styles Pro | Recraft V4.1 |
|---|---|---|---|
| Where the style comes from | 1–10 reference images | 1–10 reference images | The prompt only |
| square_hd output size | 1024×1024 | 2048×2048 | 1024×1024 |
| Size presets | 6 | 6 | 6 |
| Best for | Everyday graphics, batches in one style | Posters, print and other high-resolution uses | No references, text description only |
See live pricing for current rates.
Three steps to use it
Confirm the look in the Playground, then send the same parameters through the API.
01
1. Upload style references
Put 1–10 images in one style into image_urls.
02
2. Write the prompt and pick a size
Describe the subject and scene in prompt, choose one of the six image_size presets, and set style_match if needed.
03
3. Call /v1/tasks
The request returns a taskId right away; when the task succeeds, download the image from output[].url and store it.
Use cases
Illustration series
For article art, picture-book pages or course illustrations in one style, reuse the same references and change only the prompt.
Extending a brand look
Use existing brand illustrations as references to create new scenes; add colors when the brand palette must be fixed.
Social and campaign graphics
Keep every graphic in a campaign in one style and use portrait or landscape presets for different placements.
Style exploration
Swap in another set of references to try a different style before settling on one.
How pricing works
Billed per output image, one per request; the number of references, the size preset and style_match do not change the price.
See the live price at the top of this page and on the pricing page.
Try it with your own references
Upload references and write a prompt in the Playground above, then call POST /v1/tasks with the same parameters.
Need to compare models and billing tiers?View live pricing for all models
Frequently asked questions
What does Recraft V4 Styles do?
You set a style with 1–10 reference images and describe the content in a prompt; the model draws a new image in that style. The references decide how it looks, the prompt decides what is in it.
Are reference images required, and how many can I send?
Yes. image_urls is required: at least 1 and up to 10 images. The example on this page uses 2 illustrations in the same style.
What formats and sizes can the reference images be?
PNG, JPG or WEBP at publicly accessible http(s) URLs, each under 20 MB and no more than 64 MB in total. SVG is not supported. You can also upload images directly in the Playground.
Will objects from the references show up in the result?
In the example on this page, the teapot, books and bicycle from the references did not appear; the result shows the corner café from the prompt. What carried over was the palette, the flat shading and the hard-edged light. Put the subject you want in the prompt.
How do I choose style_match?
precise keeps the result closer to the reference style, flexible allows more variation; when omitted it behaves as flexible. The example on this page does not set style_match.
Which sizes are supported?
image_size has six presets: square_hd (default), square, portrait_4_3, portrait_16_9, landscape_4_3 and landscape_16_9. The example on this page uses square_hd and came back at 1024×1024.
How is it different from Recraft V4 Styles Pro?
The parameters are the same. Pro returns higher resolution: with square_hd, the Styles example is 1024×1024 and the Pro example is 2048×2048. Their prices differ; see live pricing.
Can I set the palette and background color?
Yes, through the API: colors takes an array of RGB objects and background_color one RGB object, each channel 0–255. The online Playground does not show these two fields yet.
Can I save a style and reuse it?
Saved styles cannot be passed in at the moment. Send the reference images with every request; to keep a set of images consistent, reuse the same references each time.
How many images per request, and in what format?
One image per request, downloaded from output[].url in the task result. The example on this page came back as a WebP image.
How is it billed?
Per output image. The number of references, the size preset and style_match do not change the price. See the current price above and on the pricing page.
How long are results kept?
Result URLs expire, so copy the image to your own storage once the task succeeds.