Skip to main content
ModelRunner
recraft avatar

Recraft V4.1 Pro API

recraft/v4.1/pro/text-to-image

Generate a polished, high-resolution raster image from a text prompt — Recraft's newest Pro tier, producing imagery up to 2048×2048 with professional composition, lighting, and materials.

0.21
OpenAPI

Model Input

Input

The text description of the image to generate (subject, scene, lighting, mood). Output is a polished, high-resolution raster image.

The size/aspect of the generated image. Pick a preset or supply an explicit width/height (up to 2048x2048 or an ultra-wide crop).

You need to be logged in to run this model and view results.
Log in

Model Output

Output

Generated image output
Generated in 15.181 seconds
Logs (1 lines)

Model Example Requests

Examples

Example output 1Example output 2Example output 3Example output 4

Recraft V4.1 Pro API

Recraft V4.1 Pro is a text-to-image AI model by recraft. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.21 per image.

POST https://queue.modelrunner.run/recraft/v4.1/pro/text-to-image

cURL

# Submit a request to the queue. Input fields go at the top level of the
# body. The optional reserved "metadata" object holds your own flat string
# tags — stored on the request, never sent to the model; filter later with
# GET https://queue.modelrunner.run/requests?metadata=<url-encoded JSON>.
curl -X POST https://queue.modelrunner.run/recraft/v4.1/pro/text-to-image \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a majestic snow leopard perched on a rocky Himalayan ridge at dawn, mist filling the valley below, ultra-detailed wil…",
    "image_size": "landscape_16_9",
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

# Poll status_url until "COMPLETED", then fetch the result
curl "https://queue.modelrunner.run/recraft/v4.1/pro/text-to-image/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/recraft/v4.1/pro/text-to-image/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("recraft/v4.1/pro/text-to-image", {
  input: {
    "prompt": "a majestic snow leopard perched on a rocky Himalayan ridge at dawn, mist filling the valley below, ultra-detailed wil…",
    "image_size": "landscape_16_9"
  },
});
console.log(result);

Python

import os
import requests

headers = {"Authorization": f"Key {os.environ['MRUN_API_KEY']}"}

submitted = requests.post(
    "https://queue.modelrunner.run/recraft/v4.1/pro/text-to-image",
    headers=headers,
    json={
      "prompt": "a majestic snow leopard perched on a rocky Himalayan ridge at dawn, mist filling the valley below, ultra-detailed wil…",
      "image_size": "landscape_16_9"
    },
).json()

# Poll submitted["status_url"] until "COMPLETED", then:
result = requests.get(submitted["response_url"], headers=headers).json()

Input parameters

NameTypeRequiredDescription
promptstringyesThe text description of the image to generate (subject, scene, lighting, mood). Output is a polished, high-resolution raster image.
image_sizeenumnoThe size/aspect of the generated image. Pick a preset or supply an explicit width/height (up to 2048x2048 or an ultra-wide crop). Default: "square_hd".

Machine-readable: OpenAPI schema · llms.txt

Use Recraft V4.1 Pro from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Recraft V4.1 Pro becomes a tool your assistant can call directly — it authorizes via OAuth (no API key in config) and runs this model with the run_model tool using the endpoint recraft/v4.1/pro/text-to-image.

MCP client config (Claude Desktop, Cursor)

{
  "mcpServers": {
    "modelrunner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp

Then ask your assistant, for example: “Run recraft/v4.1/pro/text-to-image on ModelRunner to generate image”. MCP setup guide.

Model Details

Model Details

Recraft V4.1 Pro is the newest release of Recraft's professional text-to-image model, turning a text prompt into a polished, production-ready raster image. As the premium Pro tier of the V4.1 point-release, it pushes resolution and detail further than V4 — generating high-resolution imagery up to 2048×2048 pixels and supporting ultra-wide formats — while keeping the same design-first sensibility: deliberate composition, natural lighting, and convincing material rendering suited to brand systems and production workflows. Describe the subject, scene, and mood, and the model returns a full-resolution raster image. There is no style or substyle picker to configure — the design sensibility is baked into the model, so you steer results entirely through the prompt and the chosen output size.

## Best for - High-resolution brand and campaign imagery that needs to look publication-ready straight out of the model - Photorealistic product shots, hero images, and lifestyle scenes for e-commerce and marketing - Editorial and advertising illustration where composition, lighting, and materials must feel intentional - Wide banners, posters, and large-format creative that benefit from the higher resolution and ultra-wide sizes - On-brand visuals where consistent, cohesive aesthetics matter more than a wide style menu

## Choose another model when - You need scalable SVG vector output (logos, icons, flat marks) instead of a raster image — use `recraft/v4.1/pro/text-to-vector` - You want to pick from a large library of named art styles or substyles — use `recraft/v3/text-to-image` - A lower price matters more than the newest V4.1 quality — use `recraft/v4/pro/text-to-image` - You want to edit or restyle an existing image rather than generate one from a prompt — use an image-editing model

## Tips - Lead the prompt with the details that matter most: subject, setting, lighting, camera framing, and mood - Set `image_size` to match your target format — `square_hd`, `portrait_4_3`/`portrait_16_9`, or `landscape_4_3`/`landscape_16_9`; for an exact canvas (up to 2048×2048 or an ultra-wide crop) pass a `{width, height}` object - Describe the look you want directly in the prompt — there is no separate style control to set - Be specific about materials and surfaces (matte, glossy, metal, fabric) to get the model's material rendering to shine

## Limitations - Fine, legible text inside the image can still render imperfectly - Very large custom canvases increase generation time and can occasionally soften fine detail - With prompt-only styling, dialing in a very specific named art style takes careful wording — for a large style library the V3 text-to-image model is easier

To run via the ModelRunner JavaScript client: ```js import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("recraft/v4.1/pro/text-to-image", { input: { prompt: "a matte-black wireless headphone resting on brushed concrete, dramatic side light, photorealistic product shot", image_size: "landscape_4_3", }, }); ```