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

Seedream v4 API

bytedance/seedream-v4

Seedream 4.0, üretimle düzenlemeyi tek bir mimaride birleştiren yeni nesil bir görsel üretim modelidir; gelişmiş multimodal muhakeme ve referans tutarlılığı sunarken çok daha hızlı inference ile etkileyici 4K görseller üretir.

düzenleme
L40S
0.03
OpenAPI

Model girdisi

Input

Text prompt for image generation

  • https://media.modelrunner.ai/riwy3Bb4PuJbAe1OKPuDY.png
  • https://media.modelrunner.ai/kOtI9UT6LL3PkebP

Input image(s) for image-to-image generation. List of 1-10 images for single or multi-reference generation.

The size of the generated image. Use a preset string (e.g. '4_3_1k') or a custom {width, height} object.

Group image generation mode. 'disabled' generates a single image. 'auto' lets the model decide whether to generate multiple related images (e.g., story scenes, character variations).

Min: 1 - Max: 4

Maximum number of images to generate. Each generated image is billed.

Min: -1 - Max: 2147483647

Random seed for the model. If set to -1, a random seed will be used.

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

Model çıktısı

Output

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

Örnek istekler

Örnekler

Example output 1Example output 2

Seedream v4 API

Seedream v4 is a image-to-image AI model by bytedance. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.03 per image.

POST https://queue.modelrunner.run/bytedance/seedream-v4

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-v4 \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seed": -1,
    "size": "2K",
    "width": 2048,
    "height": 2048,
    "prompt": "A realistic photo of the provided woman model, with her t-shirt seamlessly replaced by the given t-shirt image. The n…",
    "image_urls": [
      "https://media.modelrunner.ai/riwy3Bb4PuJbAe1OKPuDY.png",
      "https://media.modelrunner.ai/kOtI9UT6LL3PkebP"
    ],
    "max_images": 1,
    "num_outputs": 1,
    "aspect_ratio": "match_input_image",
    "sequential_image_generation": "disabled",
    "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-v4/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/bytedance/seedream-v4/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

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

const result = await modelrunner.subscribe("bytedance/seedream-v4", {
  input: {
    "seed": -1,
    "size": "2K",
    "width": 2048,
    "height": 2048,
    "prompt": "A realistic photo of the provided woman model, with her t-shirt seamlessly replaced by the given t-shirt image. The n…",
    "image_urls": [
      "https://media.modelrunner.ai/riwy3Bb4PuJbAe1OKPuDY.png",
      "https://media.modelrunner.ai/kOtI9UT6LL3PkebP"
    ],
    "max_images": 1,
    "num_outputs": 1,
    "aspect_ratio": "match_input_image",
    "sequential_image_generation": "disabled"
  },
});
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-v4",
    headers=headers,
    json={
      "seed": -1,
      "size": "2K",
      "width": 2048,
      "height": 2048,
      "prompt": "A realistic photo of the provided woman model, with her t-shirt seamlessly replaced by the given t-shirt image. The n…",
      "image_urls": [
        "https://media.modelrunner.ai/riwy3Bb4PuJbAe1OKPuDY.png",
        "https://media.modelrunner.ai/kOtI9UT6LL3PkebP"
      ],
      "max_images": 1,
      "num_outputs": 1,
      "aspect_ratio": "match_input_image",
      "sequential_image_generation": "disabled"
    },
).json()

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

Input parameters

Input parameters of Seedream v4
NameTypeRequiredDescription
promptstringyesText prompt for image generation
image_urlsarraynoInput image(s) for image-to-image generation. List of 1-10 images for single or multi-reference generation. Default: [].
image_sizeenumnoThe size of the generated image. Use a preset string (e.g. '4_3_1k') or a custom {width, height} object. One of: 1_1_512, 1_1_1k, 1_1_2k, 1_1_4k, 16_9_512, 16_9_1k, 16_9_2k, 16_9_4k, 9_16_512, 9_16_1k, 9_16_2k, 9_16_4k, 4_3_512, 4_3_1k, 4_3_2k, 4_3_4k, 3_4_512, 3_4_1k, 3_4_2k, 3_4_4k, 3_2_512, 3_2_1k, 3_2_2k, 3_2_4k, 2_3_512, 2_3_1k, 2_3_2k, 2_3_4k, 4_5_512, 4_5_1k, 4_5_2k, 4_5_4k, 5_4_512, 5_4_1k, 5_4_2k, 5_4_4k, 21_9_512, 21_9_1k, 21_9_2k, 21_9_4k, 9_16_512, 9_16_1k, 9_16_2k, 9_16_4k, 16_9_512, 16_9_1k, 16_9_2k, 16_9_4k. Default: "4_3_1k".
sequential_image_generationenumnoGroup image generation mode. 'disabled' generates a single image. 'auto' lets the model decide whether to generate multiple related images (e.g., story scenes, character variations). One of: disabled, auto. Default: "disabled".
max_imagesintegernoMaximum number of images to generate. Each generated image is billed. Default: 1.
seedintegernoRandom seed for the model. If set to -1, a random seed will be used. Default: -1.

Machine-readable: OpenAPI schema · llms.txt

Use Seedream v4 from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Seedream 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 bytedance/seedream-v4.

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

Model Detayları

Model Detayları

# Seedream 4.0 Kullanım Kılavuzu

Seedream 4.0, **text-to-image üretimi, görsel düzenleme, referans tabanlı üretim ve çoklu görsel oluşturmayı** tek bir birleşik mimaride toplayan yeni nesil bir görsel üretim modelidir. Önceki sürümü Seedream 3.0 ile karşılaştırıldığında Seedream 4.0 **belirgin biçimde daha hızlı inference**, daha keskin bir render ve **4K çözünürlüğe kadar yüksek tanımlı görseller** üretme imkânı sunar.

Bu da onu hem yaratıcı profesyoneller hem de teknik kullanıcılar için çok yönlü bir araç haline getirir; **bilgi temelli muhakeme, referans tutarlılığı ve stilistik hassasiyet** gerektiren işlerin altından kalkar.

---

## Genel İlkeler

Seedream 4.0 ile en iyi sonucu almak için şu yöntemleri izleyin:

1. **Sahneleri doğal biçimde tarif edin** Özne + eylem + ortam kurun, gerekiyorsa stil anahtar kelimeleri ekleyin. - ✅ *“Ağaçlıklı bir yolda şemsiyesinin altında yürüyen, gösterişli elbiseli bir kız; Monet yağlı boya tablosu tarzında.”* - ⚠️ *“Kız, şemsiye, ağaçlıklı sokak, yağlı boya dokusu.”*

2. **Amacınızı netleştirin** Kullanım senaryosunu söyleyin (logo, poster, storyboard vb.). - ✅ *“Bir oyun şirketi için logo tasarla. Logoda oyun kumandasıyla oynayan bir köpek olsun. Üzerine şirket adı `PITBULL` yazılsın.”*

3. **Net stil ipuçları verin** Stil tutarlılığı için anahtar kelimeler ya da referans görseller kullanın.

4. **Metni doğru yazdırın** Önemli metinleri **tırnak içine** alın. - ✅ *“Başlığı `Seedream 4.0` olan bir poster üret.”*

5. **Net düzenleme talimatları verin** Neyin değişeceğini ve neyin aynı kalacağını belirtin. - ✅ *“En uzun pandaya pembe bir Pekin Operası kostümü giydir, pozunu değiştirme.”*

> 💡 **İpucu:** Yeni sürüm, Seedream 3.0’a kıyasla prompt’ları daha iyi anlıyor. Aşırı sıfat yığmak yerine **kısa ve kesin prompt’lar** kullanın.

---

## Temel Yetenekler

### 1. Text-to-Image - Doğal dilden sahneler, sanat eserleri ya da teknik görseller üretin. - **Bilgi temelli illüstrasyonlarda** (formüller, diyagramlar, eğitim) güçlüdür. - Kullanım alanları: **sanat eserleri, posterler, ürün tasarımı, eğitim görselleri, pazarlama görselleri.**

### 2. Image-to-Image ve Düzenleme - Prompt’larla **ekleme, silme, değiştirme ya da düzenleme** yapın. - Düzenlenecek bölgeleri işaretlemek için **ok, kutu ve karalama** desteklenir. - Kullanım alanları: **ürün fotoğrafı düzenlemeleri, reklam revizyonları, karakter yeniden tasarımları.**

### 3. Referans Tabanlı Üretim - Bir referans görselden **stil, kimlik ya da ürün özelliklerini** çıkarın. - **Karakter sürekliliği, marka tasarımı ve stil aktarımı** için çalışır. - Eskizleri ya da kat planlarını **fotogerçekçi sonuçlara ya da UI mockup’larına** dönüştürebilir.

### 4. Çoklu Görsel Girdi ve Çıktı - **Özne değişimi, stil aktarımı ya da birleşik düzenleme** için görselleri bir araya getirin. - **Karakteri ve stili tutarlı görsel serileri** üretin. - Kullanım alanları: **storyboard, emoji paketleri, çizgi roman, IP ürün setleri.**

---

## Örnek Kullanım Senaryoları

- 🎨 **Yaratıcı Tasarım** – Marka kimliği için birden fazla logo varyasyonu üretin. - 📘 **Eğitim** – Formülleri ya da bilimsel kavramları anlaşılır diyagramlara çevirin. - 🎬 **Eğlence** – Karakterleri tüm karelerde tutarlı kalan bir storyboard oluşturun. - 🏡 **İç Mimari** – Eskizleri ya da kat planlarını fotogerçekçi odalara dönüştürün. - 📢 **Pazarlama** – Metni doğru basan poster, reklam ve banner’lar tasarlayın. - 🎮 **Oyun ve Animasyon** – Karakter tasarımını pozlar ve sahneler arasında tutarlı tutun.

---

## Daha İyi Sonuçlar için İpuçları

- **Kısa ve net bir prompt’la** başlayın → adım adım iyileştirin. - *“şu”* ya da *“şuradaki”* gibi belirsiz zamirlerden kaçının. - Süreklilik ya da stil tutarlılığı önemliyse **referans görseller** kullanın. - Metin için her zaman **çift tırnak** kullanın. - Düzenleme yaparken neyin değişmeden kalması gerektiğini açıkça yazın.