# OpenRouter APIs — Recraft: Recraft V4.1 Pro (recraft/recraft-v4.1-pro)

Guide for calling every confirmed OpenRouter API that serves `recraft/recraft-v4.1-pro`.

Model page: https://openrouter.ai/recraft/recraft-v4.1-pro
Create an API key: https://openrouter.ai/settings/keys

## Pricing

Standard-variant prices for `recraft/recraft-v4.1-pro`, per provider, in the unit each provider bills (tokens, images, seconds of video, or characters of audio). Pay-as-you-go with no markup on the provider's price.

- Recraft: $0.21/image

Full price table, including other variants and per-request charges: https://openrouter.ai/recraft/recraft-v4.1-pro
How OpenRouter prices requests: https://openrouter.ai/pricing

## EU in-region routing

`recraft/recraft-v4.1-pro` is not currently available through EU in-region routing.

Docs: https://openrouter.ai/docs/guides/features/in-region-routing

## Authentication

Send this header with every request:

- Authorization: Bearer $OPENROUTER_API_KEY

## Image API

Generate images with `recraft/recraft-v4.1-pro` through OpenRouter's Image API.

Docs: https://openrouter.ai/docs/guides/overview/multimodal/image-generation
Model discovery API: https://openrouter.ai/api/v1/images/models
Endpoints (recraft/recraft-v4.1-pro-20260514): https://openrouter.ai/api/v1/images/models/recraft/recraft-v4.1-pro-20260514/endpoints

### Endpoint

POST https://openrouter.ai/api/v1/images

Headers:
- Content-Type: application/json

### Request fields (recraft/recraft-v4.1-pro)

- model: string (required) — `"recraft/recraft-v4.1-pro"`
- prompt: string (required) — text description of the desired image
- aspect_ratio: "1:1" | "2:1" | "1:2" | "3:2" | "2:3" | "4:3" | "3:4" | "5:4" | "4:5" | "16:9" | "9:16" | "auto" (optional) — aspect ratio of the generated image
- n: integer 1-6 (optional) — upper bound on the number of images to generate; providers may return fewer, and single-image providers reject n > 1
- input_references: array of up to 1 image references (optional) — reference images for image-to-image, as `{ "type": "image_url", "image_url": { "url": "…" } }` entries; the url is an https URL or a base64 data URL

These are the generation parameters this model accepts between its providers; an
unlisted value is rejected, and a listed one can still be refused by whichever provider
serves the call. `provider` (routing preferences) is accepted on every request.

### Response

```json
{
  "created": 1748372400,
  "data": [{ "b64_json": "<base64 image bytes>", "media_type": "image/png" }],
  "usage": { "prompt_tokens": 0, "completion_tokens": 4175, "total_tokens": 4175, "cost": 0.04 }
}
```

Base64-decode `data[i].b64_json` and write the bytes to a file; `media_type` gives the extension.
`usage.cost` is the USD charge for the call.

### Examples

#### Twilight

```bash
curl -X POST https://openrouter.ai/api/v1/images \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft/recraft-v4.1-pro",
  "prompt": "Editorial architectural photograph of a contemporary neighborhood storefront at blue hour, glowing warmly against the dusk. Above the entrance, a warm-white neon sign in flowing hand-bent cursive reads exactly \"OpenRouter\", the only text in the scene. Large windows reveal a cozy, lived-in interior: wood shelves styled with books and ceramics, lush trailing plants, and soft pendant lighting. Potted plants and a bicycle rest by the entrance, and golden light spills across the wet pavement in gentle reflections. Straight-on composition, realistic materials, quiet street with no people.",
  "n": 1,
  "aspect_ratio": "16:9"
}'
```

#### Flower shop

```bash
curl -X POST https://openrouter.ai/api/v1/images \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft/recraft-v4.1-pro",
  "prompt": "Transform this storefront into a tasteful neighborhood flower shop on a bright, dry late-spring morning. Replace the shop interior and window display with a restrained, realistic selection of bouquets, potted flowers, and greenery, with a few organized flower buckets near the entrance. Make the sky and street clearly daytime, remove all wet pavement and reflections, use soft natural sunlight and realistic shadows, and turn off the neon glow while keeping the physical sign and the text \"OpenRouter\" perfectly clear and readable. Preserve the exact camera angle, framing, architecture, windows, door, bicycle, and surrounding buildings. Keep the result photorealistic and editorial, not overly decorated.",
  "n": 1,
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://model-assets.openrouter.ai/model-examples/recraft/recraft-v4.1-pro-20260514/fed49a5b-11ed-46a6-8421-dc271b93afc8/input-0.jpg"
      }
    }
  ]
}'
```

### Error differences

- 413 — request body too large

## Errors

Failures return `{"error": {"code": <number>, "message": <string>}}` with the HTTP status:

- 400 — malformed request or an unsupported parameter
- 401 — missing or invalid API key
- 402 — insufficient credits
- 403 — spend limit reached, key disabled, or access blocked
- 404 — unknown model or no provider can serve the request
- 429 — rate limited; retry with backoff
- 502 — the operation failed upstream; failed generations are not billed

---

Canonical version of this document: https://openrouter.ai/recraft/recraft-v4.1-pro/llms.txt
