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

Recraft V3 API

recraft/v3/text-to-image

Geniş bir profesyonel tasarım stili kütüphanesiyle metin prompt’undan görseller üretin; vektör stil seçtiğinizde gerçek vektör (SVG) çıktı alın — logo, ikon ve marka grafikleri için ideal.

0.04
OpenAPI

Model girdisi

Input

The text prompt describing the image to generate.

The visual style to render. Pick a top-level family or a specific substyle. Any 'vector_illustration/*' style returns a true vector (SVG) file; all other styles return a raster image. Vector styles cost more (billed at the standard rate here).

The size/aspect of the generated image.

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

Model çıktısı

Output

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

Örnek istekler

Örnekler

Example output 1Example output 2

Recraft V3 API

Recraft V3 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/v3/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/v3/text-to-image \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "style": "realistic_image",
    "prompt": "a cozy bookstore cafe interior, warm afternoon light, plants on shelves",
    "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/v3/text-to-image/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/recraft/v3/text-to-image/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

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

const result = await modelrunner.subscribe("recraft/v3/text-to-image", {
  input: {
    "style": "realistic_image",
    "prompt": "a cozy bookstore cafe interior, warm afternoon light, plants on shelves",
    "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/v3/text-to-image",
    headers=headers,
    json={
      "style": "realistic_image",
      "prompt": "a cozy bookstore cafe interior, warm afternoon light, plants on shelves",
      "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 V3
NameTypeRequiredDescription
promptstringyesThe text prompt describing the image to generate.
styleenumnoThe visual style to render. Pick a top-level family or a specific substyle. Any 'vector_illustration/*' style returns a true vector (SVG) file; all other styles return a raster image. Vector styles cost more (billed at the standard rate here). One of: any, realistic_image, digital_illustration, vector_illustration, realistic_image/b_and_w, realistic_image/enterprise, realistic_image/evening_light, realistic_image/faded_nostalgia, realistic_image/forest_life, realistic_image/hard_flash, realistic_image/hdr, realistic_image/motion_blur, realistic_image/mystic_naturalism, realistic_image/natural_light, realistic_image/natural_tones, realistic_image/organic_calm, realistic_image/real_life_glow, realistic_image/retro_realism, realistic_image/retro_snapshot, realistic_image/studio_portrait, realistic_image/urban_drama, realistic_image/village_realism, realistic_image/warm_folk, digital_illustration/2d_art_poster, digital_illustration/2d_art_poster_2, digital_illustration/antiquarian, digital_illustration/bold_fantasy, digital_illustration/child_book, digital_illustration/child_books, digital_illustration/cover, digital_illustration/crosshatch, digital_illustration/digital_engraving, digital_illustration/engraving_color, digital_illustration/expressionism, digital_illustration/freehand_details, digital_illustration/grain, digital_illustration/grain_20, digital_illustration/graphic_intensity, digital_illustration/hand_drawn, digital_illustration/hand_drawn_outline, digital_illustration/handmade_3d, digital_illustration/hard_comics, digital_illustration/infantile_sketch, digital_illustration/long_shadow, digital_illustration/modern_folk, digital_illustration/multicolor, digital_illustration/neon_calm, digital_illustration/noir, digital_illustration/nostalgic_pastel, digital_illustration/outline_details, digital_illustration/pastel_gradient, digital_illustration/pastel_sketch, digital_illustration/pop_art, digital_illustration/pop_renaissance, digital_illustration/seamless, digital_illustration/street_art, digital_illustration/tablet_sketch, digital_illustration/urban_glow, digital_illustration/urban_sketching, digital_illustration/vanilla_dreams, digital_illustration/young_adult_book, digital_illustration/young_adult_book_2, vector_illustration/bold_stroke, vector_illustration/chemistry, vector_illustration/colored_stencil, vector_illustration/contour_pop_art, vector_illustration/cosmics, vector_illustration/cutout, vector_illustration/depressive, vector_illustration/editorial, vector_illustration/emotional_flat, vector_illustration/engraving, vector_illustration/infographical, vector_illustration/line_art, vector_illustration/line_circuit, vector_illustration/linocut, vector_illustration/marker_outline, vector_illustration/mosaic, vector_illustration/naivector, vector_illustration/roundish_flat, vector_illustration/segmented_colors, vector_illustration/sharp_contrast, vector_illustration/thin, vector_illustration/vivid_shapes. Default: "realistic_image".
image_sizeenumnoThe size/aspect of the generated image. One of: 1_1_1k, 1_1_512, 4_3_1k, 3_4_1k, 16_9_1k, 9_16_1k. Default: "1_1_1k".

Machine-readable: OpenAPI schema · llms.txt

Use Recraft V3 from Claude & Cursor (MCP)

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

Model Detayları

Model Detayları

Recraft V3, bir metin prompt’unu özenle işlenmiş bir görsele dönüştürür ve özellikle tasarım işleri için geliştirilmiştir. En güçlü yanı, `style` alanından seçilen, her biri adıyla tanımlanmış geniş bir profesyonel stil kütüphanesidir — fotogerçekçi görünümler, dijital illüstrasyon ve vektör estetiği; böylece bütün bir görsel setinde aynı görsel dili koruyabilirsiniz. Bir `vector_illustration/*` stili seçtiğinizde sonuç raster bir görsel değil, gerçek bir vektör (SVG) dosyasıdır; bu da onu temiz biçimde ölçeklenmesi gereken logolar, ikonlar, posterler ve marka grafikleri için çok uygun kılar. Varsayılan raster stiller (`realistic_image`, `digital_illustration`) standart bir webp görsel döndürür.

## En uygun olduğu işler - Temiz, ölçeklenebilir vektör (SVG) çıktının önemli olduğu logolar, ikonlar ve rozetler — bir `vector_illustration/*` stili seçin - Tutarlı ve bilinçli seçilmiş bir sanat stiliyle posterler, pazarlama grafikleri ve editoryal illüstrasyon - `realistic_image` stilleri ve alt stilleriyle fotogerçekçi ürün ve lifestyle görselleri - Aynı `style` değerini birçok prompt’ta yeniden kullanarak tutarlı bir marka görselleri seti oluşturmak

## Şu durumlarda başka bir model seçin - Metinden üretmek yerine mevcut bir görseli düzenlemek, yeniden tarzlamak ya da dönüştürmek istiyorsanız — bir image-to-image ya da görsel düzenleme modeli kullanın - Hareket ya da animasyon gerekiyorsa — bir text-to-video ya da image-to-video modeli kullanın - Tek çağrıda çok sayıda varyasyon gerekiyorsa — bu model istek başına tek bir görsel döndürür - Önceliğiniz görsel içine çok miktarda ve harfi harfine doğru metin basmaksa — görsel içinde okunaklı metin konusunda uzmanlaşmış bir model kullanın

## İpuçları - Sonucu en çok etkileyen tek ayar `style`: aileleri (`realistic_image`, `digital_illustration`, `vector_illustration`) ve alt stillerini inceleyin — ör. keskin çizgili ikonlar için `vector_illustration/line_art`, portreler için `realistic_image/studio_portrait` - Özellikle ölçekleyip rengini değiştirebileceğiniz bir SVG istiyorsanız herhangi bir `vector_illustration/*` stilini seçin; diğer stil aileleri raster görsel döndürür - Kadrajı `image_size` ile belirleyin (ör. banner’lar için `landscape_16_9`, posterler için `portrait_4_3`)

## Sınırlamalar - İstek başına tek bir görsel döndürür; batch ya da varyasyon sayısı ayarı yoktur - Seed kontrolü yoktur, bu yüzden çalıştırmalar birebir tekrarlanamaz - Küçük puntolu, harfi harfine doğru yazılması gereken metinler ve kesin nesne sayıları yine de kusurlu çıkabilir

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

const result = await modelrunner.subscribe("recraft/v3/text-to-image", { input: { prompt: "a minimalist fox logo, geometric, two colors", style: "vector_illustration/line_art", image_size: "square_hd", }, }); ```