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

Seedream 5.0 Pro Image Editing API

bytedance/seedream-v5-pro/edit

Bir metin prompt’u ve 10’a kadar referans görselden yola çıkarak görsel düzenleyin, yeniden tarzlayın ve birleştirin — Seedream 5.0’ın hassas düzenlemeye yönelik premium kademesi.

düzenleme
0.09
OpenAPI

Model girdisi

Input

Text prompt describing the edit to apply to the reference image(s).

  • https://media.modelrunner.ai/XMv4k5cqfBIGGydmqJgi3.jpeg

Reference image(s) to edit or use for reference-based generation. Required — provide 1 to 10 images.

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 121.674 seconds
Logs (1 lines)

Örnek istekler

Örnekler

Example output 1Example output 2Example output 3

Seedream 5.0 Pro Image Editing API

Seedream 5.0 Pro Image Editing 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.09 per image.

POST https://queue.modelrunner.run/bytedance/seedream-v5-pro/edit

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/edit \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size": "1024x1024",
    "prompt": "Fill the white mug with a cappuccino topped with delicate leaf latte art, and add a golden-brown croissant on a small…",
    "image_urls": [
      "https://media.modelrunner.ai/XMv4k5cqfBIGGydmqJgi3.jpeg"
    ],
    "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/edit/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/bytedance/seedream-v5-pro/edit/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

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

const result = await modelrunner.subscribe("bytedance/seedream-v5-pro/edit", {
  input: {
    "size": "1024x1024",
    "prompt": "Fill the white mug with a cappuccino topped with delicate leaf latte art, and add a golden-brown croissant on a small…",
    "image_urls": [
      "https://media.modelrunner.ai/XMv4k5cqfBIGGydmqJgi3.jpeg"
    ]
  },
});
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/edit",
    headers=headers,
    json={
      "size": "1024x1024",
      "prompt": "Fill the white mug with a cappuccino topped with delicate leaf latte art, and add a golden-brown croissant on a small…",
      "image_urls": [
        "https://media.modelrunner.ai/XMv4k5cqfBIGGydmqJgi3.jpeg"
      ]
    },
).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 Image Editing
NameTypeRequiredDescription
promptstringyesText prompt describing the edit to apply to the reference image(s).
image_urlsarrayyesReference image(s) to edit or use for reference-based generation. Required — provide 1 to 10 images.
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 Image Editing from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Seedream 5.0 Pro Image Editing 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/edit.

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

Model Detayları

Model Detayları

Seedream 5.0 Pro Image Editing, Seedream 5.0 görsel ailesinin premium kademesidir ve referans tabanlı görsel düzenlemeye odaklanır. Bir ile on arasında referans görsel ve bir metin talimatı verin; model mevcut görselleri yüksek sadakatle ve talimata hassas biçimde uyarak düzenler, yeniden tarzlar ya da birleştirir. Özneleri, kimliği ve ürün ayrıntılarını referanslar arasında tutarlı tutar, görsel içinde doğru metin basar ve kabaca 1 ile ~4.2 megapiksel (2K) arasında çıktı verir. Daha büyük çıktı boyutlarının görsel başına maliyeti daha yüksektir.

## En uygun olduğu işler - Bir fotoğrafı, görselin geri kalanını değiştirmeden metin talimatıyla düzenlemek ya da yeniden tarzlamak - Referans tabanlı üretim: 10’a kadar referans görselden stil, kimlik ya da ürün ayrıntılarını aktarmak - Birden fazla ürünü, kişiyi ya da sahneyi tek ve tutarlı bir görselde birleştirmek - Mevcut bir görselde nesne eklemek, kaldırmak ya da değiştirmek - Detayın ve talimata isabetli uyumun hızdan ya da fiyattan daha önemli olduğu premium kalitede düzenlemeler

## Şu durumlarda başka bir model seçin - Referans görsel olmadan prompt’tan görsel üretmek istiyorsanız — `bytedance/seedream-v5-pro/text-to-image` kullanın - En hızlı ve en ucuz düzenlemeyi istiyorsanız ve biraz kaliteden ödün verebiliyorsanız — Lite kademesi olan `bytedance/seedream-v5/edit` 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 image-to-video modeli kullanın

## İpuçları - Kaynak görsel(ler)i `image_urls` alanında verin ve değişikliği kesin biçimde tarif edin; neyin değişmeden kalması gerektiğini de belirtin - Net ve yüksek çözünürlüklü referans görseller verin; en fazla 10 tane ekleyebilirsiniz - `size` hem çözünürlüğü hem en-boy oranını belirler; daha düşük fiyat kademesi için ~1MP bir değer (ör. `1024x1024`), 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

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

const result = await modelrunner.subscribe("bytedance/seedream-v5-pro/edit", { input: { prompt: "replace the background with a sunlit studio, keep the subject unchanged", image_urls: ["https://media.modelrunner.ai/example-photo.jpg"], size: "1024x1024", }, }); ```