Ana içeriğe geç
YeniSeedance 2.5 yayında→
ModelRunner
recraft avatarı

Recraft V4.1 API

recraft/v4.1/text-to-image

Metin prompt’undan özenle işlenmiş, yüksek çözünürlüklü bir raster görsel üretin — Recraft’ın en yeni V4.1 modeli; profesyonel kompozisyon, ışık ve malzemeyle 2048×2048’e kadar görseller, görsel başına ekonomik fiyatla.

0.035
OpenAPI

Model girdisi

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 çıktısı

Output

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

Örnek istekler

Örnekler

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

Recraft V4.1 API

Recraft V4.1 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.035 per image.

POST https://queue.modelrunner.run/recraft/v4.1/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/text-to-image \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a hand-thrown ceramic teapot glazed in deep celadon green, resting on a rough linen cloth beside dried lavender sprig…",
    "image_size": "square_hd",
    "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/text-to-image/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/recraft/v4.1/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/text-to-image", {
  input: {
    "prompt": "a hand-thrown ceramic teapot glazed in deep celadon green, resting on a rough linen cloth beside dried lavender sprig…",
    "image_size": "square_hd"
  },
});
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/text-to-image",
    headers=headers,
    json={
      "prompt": "a hand-thrown ceramic teapot glazed in deep celadon green, resting on a rough linen cloth beside dried lavender sprig…",
      "image_size": "square_hd"
    },
).json()

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

Input parameters

Input parameters of Recraft V4.1
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). One of: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Default: "square_hd".

Machine-readable: OpenAPI schema · llms.txt

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

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Recraft V4.1 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/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/text-to-image on ModelRunner to generate image”. MCP setup guide.

Model Detayları

Model Detayları

Recraft V4.1, bir metin prompt’unu özenle işlenmiş, yüksek çözünürlüklü bir raster görsele dönüştürür. Recraft’ın en yeni ara sürümü V4.1’in standart (Normal) kademesidir: V4.1 Pro kademesiyle aynı modern tasarım anlayışını paylaşır, 2048×2048 piksele kadar görsel üretip ultra geniş formatları destekleyerek çözünürlüğü ve detayı V4’ün ötesine taşır — üstelik görsel başına ekonomik bir fiyatla. Tasarım öncelikli yaklaşımını korur: marka sistemlerine ve prodüksiyon iş akışlarına uygun bilinçli kompozisyon, doğal ışık ve malzemeleri inandırıcı biçimde yansıtan render. Özneyi, sahneyi ve atmosferi tarif edin; model tam çözünürlüklü bir raster görsel döndürür. Ayarlanacak bir stil ya da alt stil seçicisi yoktur — tasarım anlayışı modelin içine işlenmiştir, bu yüzden sonucu tamamen prompt’la ve seçtiğiniz çıktı boyutuyla yönlendirirsiniz.

## En uygun olduğu işler - Temiz ve yayına hazır görünmesi gereken yüksek çözünürlüklü marka ve kampanya görselleri - E-ticaret ve pazarlama için fotogerçekçi ürün çekimleri, hero görseller ve lifestyle sahneleri - Kompozisyonun, ışığın ve malzemelerin önem taşıdığı editoryal ve reklam illüstrasyonları - Yüksek çözünürlükten ve ultra geniş boyutlardan yararlanan geniş banner’lar, posterler ve büyük formatlı kreatifler - Görsel başına düşük fiyatın önem taşıdığı yüksek hacimli görsel üretimi

## Şu durumlarda başka bir model seçin - Premium kampanya işleri için en yüksek sadakatli Pro kademesi çıktısı gerekiyorsa — `recraft/v4.1/pro/text-to-image` kullanın - Raster görsel yerine ölçeklenebilir SVG vektör çıktısı (logolar, ikonlar, düz amblemler) gerekiyorsa — `recraft/v4.1/text-to-vector` kullanın - Adlandırılmış sanat stilleri ve alt stillerden oluşan geniş bir kütüphaneden seçim yapmak istiyorsanız — `recraft/v3/text-to-image` kullanın - Prompt’tan üretmek yerine mevcut bir görseli düzenlemek ya da yeniden tarzlamak istiyorsanız — bir görsel düzenleme modeli kullanın

## İpuçları - Prompt’a en önemli ayrıntılarla başlayın: özne, mekân, ışık, kamera kadrajı ve atmosfer - `image_size` değerini hedef formatınıza göre ayarlayın — `square_hd`, `portrait_4_3`/`portrait_16_9` ya da `landscape_4_3`/`landscape_16_9`; kesin bir tuval için (2048×2048’e kadar ya da ultra geniş bir kadraj) bir `{width, height}` nesnesi verin - İstediğiniz görünümü doğrudan prompt’ta tarif edin — ayarlanacak ayrı bir stil kontrolü yoktur - Modelin malzeme render’ının hakkını vermesi için malzemeler ve yüzeyler (mat, parlak, metal, kumaş) konusunda net olun

## Sınırlamalar - Görsel içindeki küçük ve okunaklı olması gereken metin hâlâ kusurlu basılabilir - Çok büyük özel tuvaller üretim süresini uzatır ve zaman zaman ince detayları yumuşatabilir - En yüksek sadakatli çıktı için Pro kademesi (`recraft/v4.1/pro/text-to-image`) bir adım daha ileri ayarlanmıştır

ModelRunner JavaScript client ile çalıştırmak için: ```js import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("recraft/v4.1/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", }, }); ```