Source: https://ailoot.ai/models/en/recraft-recraft-v4-styles-pro/
Canonical: https://ailoot.ai/models/en/recraft-recraft-v4-styles-pro/
Language: en

# Recraft: Recraft V4 Styles Pro

[Markdown](https://ailoot.ai/models/en/recraft-recraft-v4-styles-pro/index.md) · [JSON](https://ailoot.ai/models/en/recraft-recraft-v4-styles-pro/facts.json)

## [Recraft: Recraft V4 Styles Pro](https://ailoot.ai/models/en/recraft-recraft-v4-styles-pro/)

Recraft V4 Styles Pro generates 2K raster images in a reference-defined visual style. It is designed for detailed campaign assets and image sets whose texture, rendering, palette and overall look should remain consistent as the subject changes.

- [**Ailoot Ultra · Images** `POST /v1/images/generations` `recraft/recraft-v4-styles-pro`](https://ailoot.ai/models/en/recraft-recraft-v4-styles-pro/#method-0)

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

Recraft V4 Styles Pro is the higher-resolution raster model in Recraft’s dedicated V4 Styles family. It creates a new image from a text brief and a visual style supplied through reference images or a saved style. The model is intended for campaigns, brand illustration and other image sets where rendering, texture and compositional character need to carry from one asset to the next. It is separate from Recraft V4 Pro and V4.1 Pro, whose style input is optional rather than the defining requirement of the model.

Styles Pro produces 2K raster output, with lossless WebP or PNG formats. A square output in the producer size table is 2048 × 2048 pixels, while a 16:9 output is 2688 × 1536; other supported ratios have their own dimensions. Pro’s larger output can be useful for detailed campaign visuals and larger layouts. The vector variants instead produce SVG and have no fixed pixel size, so this raster Pro edition should not be selected when the intended deliverable is an editable vector file.

Every generation in the Styles family requires a style. Supply one to ten PNG, JPG or WebP reference images, or reuse a compatible saved style; a style identifier and new references are alternative inputs rather than a pair to combine. The producer workflow permits up to 64 MB across references, with each file under 20 MB. Style creation does not require a user-run training step. One clear reference can establish a coherent direction, and several references help when they already share the same visual language rather than competing looks. Each reference must have a shortest side of at least 256 pixels, a longest side of no more than 4,096 pixels and a total resolution of no more than 16 megapixels.

Flexible style matching is the default and allows a looser interpretation of the reference. Precise matching follows rendering, palette, composition and lighting more closely. The reference defines the visual language; the text brief still needs to describe the new subject, action, scene and framing. For a detailed product campaign, specify a glass bottle on a pale stone surface, a three-quarter view, soft side lighting and clear space for a headline, while the supplied reference carries the photographic treatment.

The model accepts prompts up to 10,000 characters, supports preferred colours and a desired background colour, and can use a random seed. The documented generation workflow can return one to six images. Its useful controls differ from older Recraft editions: curated style names, negative\_prompt and text\_layout are not supported, and the Styles family does not provide image-to-image or inpainting. A reference is a style source, not a mask or an instruction to preserve an existing photograph pixel for pixel.

Prepare clean, sufficiently detailed reference assets and reuse the same style when developing a set. If outputs become repetitive, change the subject, pose, camera angle or scene in the text brief instead of adding an unrelated reference. Exact reference-to-output colour matching is not guaranteed; preferred-colour controls express a direction rather than a colour-proofing result. For the final campaign asset, assess the image at its intended display or print size and check whether the subject, useful negative space and visual treatment match the brief.

**Ailoot Ultra · Images** `POST /v1/images/generations` `recraft/recraft-v4-styles-pro`

[`recraft/recraft-v4-styles-pro`](https://ailoot.ai/models/en/#m=recraft%2Frecraft-v4-styles-pro&route=Ultra&caller=recraft%2Frecraft-v4-styles-pro&fmt=images)

Recraft /`recraft/recraft-v4-styles-pro`

### Overview

Recraft V4 Styles Pro generates 2K raster images in a reference-defined visual style. It is designed for detailed campaign assets and image sets whose texture, rendering, palette and overall look should remain consistent as the subject changes.

Accepted inputs

Text · Images

Results

Images

### Available in Ailoot · inputs & methods

**Ailoot Ultra · Images** `POST /v1/images/generations`

Input types

`text`, `image`

Output types

`image`

| Field | Type | Requirement | Values & limits | Default |
| --- | --- | --- | --- | --- |
| Field`model` | Type`string` | RequirementRequired | Values & limits recraft/recraft-v4-styles-pro | Default— |
| Field`prompt` | Type`string` | RequirementRequired | Values & limits Minimum length: 1 | Default— |
| Field`aspect_ratio` | Type`string` | RequirementOptional | Values & limits 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto | Default— |
| Field`n` | Type`integer` | RequirementOptional | Values & limits Minimum: 1 Maximum: 6 | Default— |
| Field`input_references` | Type`array` | RequirementOptional | Values & limits Minimum items: 1 Maximum items: 10 | Default— |
| Field`provider` | Type`object` | RequirementOptional | Values & limits | Default— |

Method parameters and lifecycle

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractmodel, prompt |
| Parameter`material_types` | Contracttext, image |

Lifecycle: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · actual returned task\_id or media library record

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Pricing

##### How the final charge is calculated

The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode

Not specified When fast mode is selected

Flex mode

Not specified When flex mode is selected

Maximum reasoning effort

Not specified When maximum reasoning effort uses the default adjustment

#### Estimated rates for comparison

#### Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

| Configuration | Rate schedule | Forecast quantity | Billing unit | Billing conditions | Charge |
| --- | --- | --- | --- | --- | --- |
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Billing unit— | Billing conditions— | Charge Input · Input tokens · Estimate for comparison only **—** / 1K tokens Output · Output tokens · Estimate for comparison only **—** / 1K tokens Input · Cache read · Estimate for comparison only **—** / 1K tokens Input · Cache write · Estimate for comparison only **—** / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only **—** / 1K tokens |
| ConfigurationInput reference | Rate schedule— | Forecast quantity— | Billing unitper request | Billing conditionsStyle creation when generating with style references; once per request, in addition to the output-image price. | Charge Input · Input reference · Estimate for comparison only **$0.01** per request |
| Configurationoutput image | Rate schedule— | Forecast quantity— | Billing unitper output image | Billing conditions— | Charge Output · output image · Estimate for comparison only **$0.2** per output image |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Billing unit— | Billing conditions— | Charge Output · Estimated generation cost · Estimate for comparison only **$0.2** estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/)

### Example requests

#### Ailoot Ultra · Images

curl

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4-styles-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

### Receive and save results

#### Ailoot Ultra · Images

Download each returned image or save its Base64 contents

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Other content reads

Read existing owned assets

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
```

##### Keep all completed results

Save every completed image; retrieve each returned URL or decode its Base64 contents.

Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

##### If the original response needs checking

Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task\_id/asset\_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation.

Response fields

| Field | Type |
| --- | --- |
| Field`created` | Type |
| Field`data[].url` | Type |
| Field`data[].b64_json` | Type |
| Field`usage` | Type |

### Aliases

#### Model aliases

**Ailoot Ultra** [`recraft/recraft-v4-styles-pro`](https://ailoot.ai/models/en/#m=recraft%2Frecraft-v4-styles-pro&route=Ultra&caller=recraft%2Frecraft-v4-styles-pro&fmt=images)

#### Method path aliases

`/v1/images`

#### Related caller IDs

[`recraft/recraft-v4-styles-pro`](https://ailoot.ai/models/en/#m=recraft%2Frecraft-v4-styles-pro&route=Ultra&caller=recraft%2Frecraft-v4-styles-pro&fmt=images)

FAQ · Recraft: Recraft V4 Styles Pro

What inputs and results are available?

`POST /v1/images/generations` · `recraft/recraft-v4-styles-pro`: `text`, `image` → `image`

Which fields does the request use?

`POST /v1/images/generations` · `recraft/recraft-v4-styles-pro`: `model`, `prompt`, `aspect_ratio`, `n`, `input_references`, `provider`

What limits apply?

`POST /v1/images/generations` · `recraft/recraft-v4-styles-pro`: `n.minimum`: `1`; `n.maximum`: `6`

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

## The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

## Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription

Choose a discounted plan for your regular requests.

Promo code: up to 50% off

Enter your code at checkout. The price updates to reflect the current promotion.

Spending in your history

The model, tokens and amount are recorded for each request.

[Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/)

## Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application

Add text, image, video and audio generation to paid features in your service.

Reseller licence

Send a description of your project and how you provide access. Request written terms for use and resale.

Documents on the website

The service offer, licence agreement and data processing policy are available before you connect.

[Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en)

## Ailoot · The company and its project portfolio





Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control.





The company and its project portfolio: millions of customers; monthly sales in the billions.





Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.
