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

Seedream 5.0 Pro Text to Image API

bytedance/seedream-v5-pro/text-to-image

Metin prompt’undan, görsel içinde doğru yazılmış metin ve keskin detayla yüksek çözünürlüklü görseller üretin — Seedream 5.0’ın premium kademesi.

0.09
OpenAPI

Model girdisi

Input

Text prompt describing the image to generate.

Output image dimensions as WxH pixels. Values at or below ~2.36 megapixels (e.g. 1024x1024, 1376x768) bill at the lower price tier; higher-resolution values (e.g. 2048x2048) bill at the premium tier.

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

Model çıktısı

Output

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

Örnek istekler

Örnekler

Example output 1Example output 2Example output 3

Seedream 5.0 Pro Text to Image API

Seedream 5.0 Pro Text to Image is a text-to-image AI model by bytedance. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.09 per image.

POST https://queue.modelrunner.run/bytedance/seedream-v5-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/bytedance/seedream-v5-pro/text-to-image \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size": "1264x848",
    "prompt": "A weathered lighthouse standing on a rugged Atlantic cliff during a violent storm, sea spray exploding against dark b…",
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

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

JavaScript

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

const result = await modelrunner.subscribe("bytedance/seedream-v5-pro/text-to-image", {
  input: {
    "size": "1264x848",
    "prompt": "A weathered lighthouse standing on a rugged Atlantic cliff during a violent storm, sea spray exploding against dark b…"
  },
});
console.log(result);

Python

import os
import requests

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

submitted = requests.post(
    "https://queue.modelrunner.run/bytedance/seedream-v5-pro/text-to-image",
    headers=headers,
    json={
      "size": "1264x848",
      "prompt": "A weathered lighthouse standing on a rugged Atlantic cliff during a violent storm, sea spray exploding against dark b…"
    },
).json()

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

Input parameters

Input parameters of Seedream 5.0 Pro Text to Image
NameTypeRequiredDescription
promptstringyesText prompt describing the image to generate.
sizeenumnoOutput image dimensions as WxH pixels. Values at or below ~2.36 megapixels (e.g. 1024x1024, 1376x768) bill at the lower price tier; higher-resolution values (e.g. 2048x2048) bill at the premium tier. One of: 1024x1024, 1376x768, 768x1376, 1264x848, 848x1264, 1200x896, 896x1200, 2048x2048, 2752x1536, 1536x2752, 2528x1696, 1696x2528, 2400x1792, 1792x2400. Default: "1024x1024".

Machine-readable: OpenAPI schema · llms.txt

Use Seedream 5.0 Pro Text to Image from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Seedream 5.0 Pro Text to Image 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 bytedance/seedream-v5-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 bytedance/seedream-v5-pro/text-to-image on ModelRunner to generate image”. MCP setup guide.

Model Detayları

Model Detayları

Seedream 5.0 Pro Text to Image, Seedream 5.0 görsel ailesinin premium kademesidir ve yazılı bir prompt’tan görsel üretmeye odaklanır. Bir metin prompt’u verin; model keskin detaylar, görsel içinde doğru ve okunaklı yazılmış metinler ve güçlü prompt uyumuyla tutarlı sahneler üretir. Çıktılar kabaca 1 ile ~4.2 megapiksel (2K) arasında değişir; böylece işe uyan çözünürlüğü ve en-boy oranını seçebilirsiniz. Daha büyük çıktı boyutlarının görsel başına maliyeti daha yüksektir.

## En uygun olduğu işler - Yazılı bir açıklamadan yüksek sadakatli text-to-image üretimi - Görsel içinde doğru ve okunaklı metin basmak (poster, logo, UI mockup, reklam) - Detayın ve prompt’a isabetli uyumun önemli olduğu fotogerçekçi sahneler ve ürün çekimleri - 2K çözünürlüğe kadar konsept çizim, illüstrasyon ve pazarlama görselleri - Detayın hızdan ya da fiyattan daha önemli olduğu premium kalitede üretim

## Şu durumlarda başka bir model seçin - Mevcut bir görseli referans görsellerle düzenlemek, yeniden tarzlamak ya da birleştirmek istiyorsanız — `bytedance/seedream-v5-pro/edit` kullanın - En hızlı ve en ucuz üretimi istiyorsanız ve biraz kaliteden ödün verebiliyorsanız — Lite kademesi olan `bytedance/seedream-v5/text-to-image` kullanın - Tek çağrıda birden fazla görsel gerekiyorsa — bu kademe istek başına tek bir görsel döndürür - Durağan görsel değil video gerekiyorsa — bir text-to-video modeli kullanın

## İpuçları - `size` hem çözünürlüğü hem en-boy oranını belirler; daha düşük fiyat kademesi için ~1MP bir değer (ör. `1024x1024`, `1376x768`), premium kademede en yüksek detay için 2K bir değer (ör. `2048x2048`) seçin - En doğru yazım için basılmasını istediğiniz metni prompt içinde tırnak içine alın - Özneyi, stili, ışığı ve kompozisyonu açıkça tarif edin — model ayrıntılı prompt’ları yakından izler

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

const result = await modelrunner.subscribe("bytedance/seedream-v5-pro/text-to-image", { input: { prompt: "a serene mountain lake at golden hour, photorealistic, sharp reflection", size: "1024x1024", }, }); ```