{"id":"recraft/recraft-v4-1","name":"Recraft V4.1","vendor":"Recraft","kind":"image","description":"Create a 1K raster image from a brief. A palette, background color and style references help a series share an art direction.","useCases":["Explore cover art in a chosen palette","Build a series of editorial illustrations from the same references"],"technical":[{"label":"API model ID","value":"recraft/recraft-v4-1"},{"label":"Provider","value":"Recraft"},{"label":"Modality","value":"Image"},{"label":"Input","value":"Text prompt · Images"},{"label":"Output","value":"Image"},{"label":"Endpoint","value":"POST /v2/jobs"},{"label":"Workflow","value":"Text to image"}],"parameters":[{"name":"prompt","type":"string","description":"What to generate, 1 to 10000 characters.","required":true,"options":"1–10000 characters"},{"name":"image_format","type":"string","description":"The raster format of the result: `webp` (lossless, the default) or `png`; a vector result is always SVG.","optionValues":["webp","png"]},{"name":"random_seed","type":"integer","description":"Random seed, a whole number from 0 to 4294967295; set it for reproducible generation.","options":"0–4294967295"},{"name":"controls","type":"object","description":"Color preferences for the result: `colors` (up to 10) and `background_color`."},{"name":"controls.colors","type":"array","description":"Suggest up to 10 colors. Each palette entry requires an rgb array of exactly three integers from 0 to 255, in red, green, blue order.","options":"Up to 10 items","details":["To weight the palette, give every color a weight between 0 and 1. The weights may add up to at most 1. To leave the palette unweighted, omit weight from every color.","An optional std array gives the color spread as one number per RGB channel. The API publishes no numeric bounds for std."]},{"name":"controls.background_color","type":"object","description":"The preferable background color."},{"name":"controls.background_color.rgb","type":"array","description":"The color as three whole numbers from 0 to 255: red, green, blue.","requiredWithin":"controls.background_color","options":"3–3 items"},{"name":"controls.background_color.std","type":"array","description":"The spread of the color around `rgb`, one number per channel (the vendor's `std`); it does not change the price."},{"name":"controls.background_color.weight","type":"number","description":"Set the relative preference for the background color with a number from 0 to 1.","options":"0–1"},{"name":"size","type":"string","description":"An aspect ratio such as `16:9` or an exact 1K size such as `1024x1024`; when omitted, one is picked from the prompt.","optionValues":["1:1","2:1","1:2","3:2","2:3","4:3","3:4","5:4","4:5","6:10","14:10","10:14","16:9","9:16","1024x1024","1536x768","768x1536","1280x832","832x1280","1216x896","896x1216","1152x896","896x1152","832x1344","1280x896","896x1280","1344x768","768x1344"]},{"name":"style_id","type":"string","description":"The id (a UUID) of a style to generate in: a public or shared style of the same model, or one an earlier request made from `style_reference_urls`; it cannot be combined with `style_reference_urls`."},{"name":"style_reference_urls","type":"array","description":"1 to 10 public https URLs of PNG, JPEG or WEBP images whose style the result borrows (64 MB in total); a job does not return the `style_id` of the style they make; the references are priced once per request.","options":"1–10 items"},{"name":"style_match","type":"string","description":"How closely the result follows the style: `flexible` or `precise`; when omitted, the style's own setting applies.","optionValues":["flexible","precise"]},{"name":"zdr","type":"boolean","description":"When enabled, Recraft skips logging or storing your prompt and reference images. Recraft still stores the output to serve its URL. ZDR adds no charge."}],"pricing":{"currency":"USD","generated":"2026-11-21T02:23:44Z","notes":["Billed per image delivered; n multiplies the price."],"rates":[{"charge":"per image","options":"","price":0.035,"from":null,"until":null,"note":null,"status":"active"},{"charge":"style references, once per request","options":"","price":0.005,"from":null,"until":null,"note":"added to the per-image price of the request","status":"active"}]},"links":{"page":"https://sociaro.com/models/recraft/recraft-v4-1","markdown":"https://sociaro.com/models/recraft/recraft-v4-1.md","json":"https://sociaro.com/models/recraft/recraft-v4-1.json","pricing":"https://sociaro.com/pricing?model=recraft%2Frecraft-v4-1","docs":"https://docs.sociaro.com/models/recraft-recraft-v4-1/","playground":"https://my.sociaro.com/playground/?model=recraft/recraft-v4-1"},"examples":[{"kind":"image","title":"Cherry-red roller skate","caption":"A single patent-leather skate stands on a pale mint sweep, with cream laces and coral wheels.","src":"https://previews.sociaro.com/shared/promo/gallery/creative/roller-skate.webp","references":[]},{"kind":"image","title":"Studio presenter","caption":"A woman with a dark bob faces the camera in a saffron jacket against a fuchsia studio backdrop.","src":"https://previews.sociaro.com/shared/promo/gallery/alibaba-video/wan-studio-presenter-portrait.png","width":1280,"height":832,"references":[]},{"kind":"image","title":"Profile in orange","caption":"Orange glasses and a metallic jacket stand out against a saturated blue backdrop.","src":"https://previews.sociaro.com/shared/promo/catalog/recraft-portrait.webp","references":[]},{"kind":"image","title":"Vermilion stairs","caption":"A pedestrian crosses a red staircase beneath a cobalt sky.","src":"https://previews.sociaro.com/shared/promo/catalog/recraft-architecture.webp","references":[]}]}