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

Recraft V4 API

recraft/v4/text-to-image

Metin prompt’undan özenle işlenmiş bir raster görsel üretin — Recraft V4’ün standart kademesi; profesyonel kompozisyon, ışık ve malzeme, görsel başına ekonomik fiyatla.

0.04
OpenAPI

Model girdisi

Input

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

The size/aspect of the generated image. Pick a preset or supply an explicit width/height.

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

Model çıktısı

Output

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

Örnek istekler

Örnekler

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

Recraft V4 API

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

POST https://queue.modelrunner.run/recraft/v4/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/text-to-image \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a minimalist product photograph of three artisanal dark-chocolate truffles dusted with cocoa on a slate plate, soft s…",
    "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/text-to-image/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/recraft/v4/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/text-to-image", {
  input: {
    "prompt": "a minimalist product photograph of three artisanal dark-chocolate truffles dusted with cocoa on a slate plate, soft s…",
    "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/text-to-image",
    headers=headers,
    json={
      "prompt": "a minimalist product photograph of three artisanal dark-chocolate truffles dusted with cocoa on a slate plate, soft s…",
      "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
NameTypeRequiredDescription
promptstringyesThe text description of the image to generate (subject, scene, lighting, mood). Output is a polished raster image.
image_sizeenumnoThe size/aspect of the generated image. Pick a preset or supply an explicit width/height. 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 from Claude & Cursor (MCP)

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

Model Detayları

Model Detayları

Recraft V4, bir metin prompt’unu özenle işlenmiş bir raster görsele dönüştürür. Recraft V4 ailesinin standart (Normal) kademesidir: Pro kademesiyle aynı modern tasarım anlayışını taşır; profesyonel kompozisyon, ışık, malzeme ve estetik bütünlük için ayarlanmıştır — üstelik görsel başına ekonomik bir fiyatla. Ö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 gündelik marka ve kampanya görselleri - E-ticaret ve pazarlama için fotogerçekçi ürün çekimleri, hero görseller ve lifestyle sahneleri - Kompozisyonun ve ışığın önem taşıdığı editoryal ve reklam illüstrasyonları - Seçtiğiniz en-boy oranında (kare, dikey ya da yatay) poster, reklam ve sosyal medya kreatifleri - 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/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/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 - Durağan görsel değil video gerekiyorsa — bir text-to-video 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 bir `{width, height}` nesnesi verin (her kenar en fazla 14142 px) - İ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/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/text-to-image", { input: { prompt: "a single red apple on a clean white studio background, soft natural light, photorealistic product shot", image_size: "square_hd", }, }); ```