Recraft V4 Styles Pro

Recraft V4 Styles Pro. New images in the style of an uploaded reference image, which is required.

POST/v1/media/queue

from $0.23/image

Overview

Style-consistent image generation via Recraft V4 Styles Pro, the Pro tier of V4 Styles. Upload a style reference and describe the subject; the model generates a new image in that style. Async operation — submit a job, poll for completion.

Property	Value
Model ID	`recraft/recraft-v4-styles-pro`
Alias	`recraft-styles-pro`
Provider	Recraft
Category	Image Generation
Aspect Ratios	1:1, 4:3, 3:4, 16:9, 9:16, auto
Output Formats	webp
Input Image	Required (`imageData`)
Billing	Dynamic (actual cost per job)
Typical Cost	~$0.23 per image

Usage

All media models use the async job queue. Submit a job, then poll for the result.

Step 1: Submit Job

Style Reference (Required)

recraft/recraft-v4-styles-pro generates a new image in the style of a reference image. Send the style reference via imageData and describe the subject in prompt. Requests without imageData are rejected.

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'recraft/recraft-v4-styles-pro',
    prompt: 'A cozy reading nook with a sleeping cat, in the style of the reference image',
    options: { aspectRatio: '1:1' },
    imageData: {
      mimeType: 'image/png',
      base64: '...', // Base64-encoded image
    },
  }),
});
const { data } = await res.json();
// data.jobId — use this to poll for results

curl -X POST https://api.yepapi.com/v1/media/queue \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "recraft/recraft-v4-styles-pro", "prompt": "A cozy reading nook with a sleeping cat, in the style of the reference image", "options": {"aspectRatio": "1:1"}, "imageData": {"mimeType": "image/png", "base64": "BASE64_IMAGE"}}'

Warning

imageData is required. A request without it fails at submit time with: recraft/recraft-v4-styles-pro needs an input image: send it in imageData.

Step 2: Poll for Result

const status = await fetch(`https://api.yepapi.com/v1/media/status/${data.jobId}`, {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status — "pending" | "processing" | "completed" | "failed"
// job.result.image — { mimeType, base64 } when completed

curl https://api.yepapi.com/v1/media/status/JOB_ID \
  -H "x-api-key: YOUR_API_KEY"

Request Body

Parameter	Type	Required	Description	Default
`model`	`string`	Yes	`recraft/recraft-v4-styles-pro` or alias `recraft-styles-pro`	—
`prompt`	`string`	Yes	Text description of the subject to generate in the reference style	—
`options.aspectRatio`	`string`	No	One of: 1:1, 4:3, 3:4, 16:9, 9:16, auto	`1:1`
`options.outputFormat`	`string`	No	`webp`	`webp`
`imageData.mimeType`	`string`	Yes	MIME type of the input image (image/png, image/jpeg, image/webp)	—
`imageData.base64`	`string`	Yes	Base64-encoded style reference image	—

Features

Generates a new image in the rendering style of a reference image
Requires a style reference image in imageData
Prompt describes the subject
Pro tier of Recraft V4 Styles
WebP output by default

Pricing

Billing is dynamic — each job is billed from the actual cost of that generation.

Metric	Cost
Typical cost per image	~$0.23

Info

Image jobs typically complete in 5–60 seconds. Results retained for 1 hour.

Under the Hood

Recraft V4 Styles Pro

On this page