Ana içeriğe geç
recraft avatarı

Recraft V4.1 Pro API

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

Metin prompt’undan premium, prodüksiyon kalitesinde, ölçeklenebilir bir vektör (SVG) grafik üretin — Recraft V4.1’in profesyonel Pro kademesi; bütünlüklü kompozisyon ve malzemelerle marka sistemi logoları, ikonları ve illüstrasyonları için ayarlanmış.

0.3

Model girdisi

Input

The text description of the vector graphic to generate (e.g. a logo, icon, or illustration). Output is a scalable SVG.

The size/aspect of the generated vector graphic. 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.816 seconds
Logs (1 lines)

Örnek istekler

Örnekler

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.3 per image.

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

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-vector \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a flat line-art compass rose icon, single deep-navy stroke on white, symmetrical, app-icon framing",
    "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/pro/text-to-vector/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/recraft/v4.1/pro/text-to-vector/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-vector", {
  input: {
    "prompt": "a flat line-art compass rose icon, single deep-navy stroke on white, symmetrical, app-icon framing",
    "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/pro/text-to-vector",
    headers=headers,
    json={
      "prompt": "a flat line-art compass rose icon, single deep-navy stroke on white, symmetrical, app-icon framing",
      "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 Pro
NameTypeRequiredDescription
promptstringyesThe text description of the vector graphic to generate (e.g. a logo, icon, or illustration). Output is a scalable SVG.
image_sizeenumnoThe size/aspect of the generated vector graphic. 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.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-vector.

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-vector on ModelRunner to generate image”. MCP setup guide.

Model Detayları

Model Detayları

Recraft V4.1 Pro, Recraft’ın en yeni text-to-vector modelinin premium kademesidir: bir metin prompt’unu raster bir görsele değil, gerçekten ölçeklenebilir bir SVG grafiğe dönüştürür. Standart V4.1 vektör modeliyle aynı tasarım işlerini hedefler — her boyutta keskin kalan logolar, ikonlar, amblemler ve düz illüstrasyonlar — ama marka sistemlerine ve prodüksiyon iş akışlarına uygun profesyonel kompozisyonu, ışığı, malzemeleri ve bütünlüklü estetiği öne çıkarır. Çıktı gerçek SVG olduğu için onu herhangi bir vektör editöründe açıp kalite kaybı olmadan yeniden renklendirebilir, yeniden boyutlandırabilir ya da path’leri düzenleyebilirsiniz. Vektör estetiği modelin içine işlenmiştir; yalnızca ne istediğinizi tarif edersiniz — ayarlanacak bir stil ya da alt stil seçicisi yoktur.

## En uygun olduğu işler - Prodüksiyon kalitesinde marka sistemleri: temiz biçimde ölçeklenmesi ve SVG olarak düzenlenebilir kalması gereken logo setleri, logotipler ve uygulama ikonları - Kompozisyonun ve malzeme bütünlüğünün önem taşıdığı özenle işlenmiş düz tasarım illüstrasyonları, çıkartmalar ve spot grafikler - Bir ürünün tamamında tutarlı, profesyonel bir görsel dil gerektiren ikon setleri ve piktogramlar - Sınırsız ölçeklenebilirlik ve rafine bir estetik isteyen baskıya hazır işler (poster, ambalaj, tabela) - Sonradan bir vektör editöründe yeniden renklendirmeyi ya da üzerinde ince ayar yapmayı planladığınız tasarım öğeleri

## Şu durumlarda başka bir model seçin - Premium Pro kademesine ihtiyacınız yoksa — aynı vektör çıktıyı daha düşük fiyata veren standart `recraft/v4.1/text-to-vector` modelini kullanın - Düz vektör çizim yerine fotogerçekçi ya da resimsel bir raster görsel istiyorsanız — genel bir text-to-image modeli kullanın - Elinizde zaten raster bir logo ya da eskiz varsa ve yalnızca SVG’ye çevrilmesi gerekiyorsa — bir vektörleştirme modeli (`recraft/vectorize`) kullanın - Metinden üretmek yerine mevcut bir görseli düzenlemeniz ya da yeniden tarzlamanız gerekiyorsa — bir image-to-image modeli kullanın - Adlandırılmış sanat stilleri ya da alt stillerden oluşan geniş bir kütüphane gerekiyorsa — stil seçici sunan `recraft/v3/text-to-image` modelini kullanın

## İpuçları - Modelin üretmek için tasarlandığı SVG çıktıya uygun düşmesi için grafiği düz tasarım terimleriyle tarif edin ("flat vector", "line icon", "minimal geometric", "two-color") - Prompt’ları tek ve net bir özneye odaklı tutun; sade, ikonik kompozisyonlar en temiz vektör sonucunu verir - Kadrajı `image_size` ile belirleyin (ör. ikon ve logolar için `square_hd`, banner’lar için `landscape_16_9`) - Kalite kaybı olmadan yeniden renklendirmek ya da boyutlandırmak için dönen `.svg` dosyasını bir vektör editöründe açın

## Sınırlamalar - İstek başına tek bir grafik döndürür; batch ya da varyasyon sayısı seçeneği yoktur - Seed kontrolü yoktur, bu yüzden çalıştırmalar birebir tekrarlanamaz - En çok temiz, ikonik vektör çizime uygundur — çok detaylı ya da fotogerçekçi sahneler tasarım amacının dışındadır - Görsel içindeki küçük ve harfi harfine doğru yazılması gereken metin hâlâ kusurlu basılabilir

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

const result = await modelrunner.subscribe("recraft/v4.1/pro/text-to-vector", { input: { prompt: "a minimalist geometric fox logo, two colors, flat vector", image_size: "square_hd", }, }); ```