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

Seedream 5.0 Lite Image Editing API

bytedance/seedream-v5/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 hızlı ve uygun fiyatlı Lite kademesi.

düzenleme
0.035
OpenAPI

Model girdisi

Input

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

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

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

Output image dimensions as WxH pixels, which set both resolution and aspect ratio. All options are 2K-class (~3.7-4.3 megapixels); this tier does not produce smaller images. Match the aspect ratio to your source image to avoid unwanted cropping. Price is flat regardless of the value chosen.

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

Model çıktısı

Output

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

Örnek istekler

Örnekler

Example output 1Example output 2Example output 3

Seedream 5.0 Lite Image Editing API

Seedream 5.0 Lite 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.035 per image.

POST https://queue.modelrunner.run/bytedance/seedream-v5/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/edit \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size": "2528x1696",
    "prompt": "Replace the walnut desk surface with white Carrara marble veined in grey, keeping the notebook, fountain pen and coff…",
    "image_urls": [
      "https://media.modelrunner.ai/vXhgUD3mbM9w7QXC8XIpm.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/edit/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/bytedance/seedream-v5/edit/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

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

const result = await modelrunner.subscribe("bytedance/seedream-v5/edit", {
  input: {
    "size": "2528x1696",
    "prompt": "Replace the walnut desk surface with white Carrara marble veined in grey, keeping the notebook, fountain pen and coff…",
    "image_urls": [
      "https://media.modelrunner.ai/vXhgUD3mbM9w7QXC8XIpm.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/edit",
    headers=headers,
    json={
      "size": "2528x1696",
      "prompt": "Replace the walnut desk surface with white Carrara marble veined in grey, keeping the notebook, fountain pen and coff…",
      "image_urls": [
        "https://media.modelrunner.ai/vXhgUD3mbM9w7QXC8XIpm.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 Lite 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. Reference images are free on this tier.
sizeenumnoOutput image dimensions as WxH pixels, which set both resolution and aspect ratio. All options are 2K-class (~3.7-4.3 megapixels); this tier does not produce smaller images. Match the aspect ratio to your source image to avoid unwanted cropping. Price is flat regardless of the value chosen. One of: 2048x2048, 2752x1536, 1536x2752, 2528x1696, 1696x2528, 2400x1792, 1792x2400. Default: "2048x2048".

Machine-readable: OpenAPI schema · llms.txt

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

Model Detayları

Model Detayları

Seedream 5.0 Lite Image Editing, yazılı bir talimatı verdiğiniz bir ya da birden fazla görsele uygular. En fazla on referans görsel ve bir prompt verin; model bunları düzenleyerek, yeniden tarzlayarak ya da birleştirerek 2K sınıfında, tek ve tutarlı bir sonuç üretir. Seedream 5.0 ailesinin hızlı ve uygun fiyatlı kademesidir: referans görseller ücretsizdir ve her çıktı görsel başına aynı sabit fiyatla faturalandırılır.

## En uygun olduğu işler - Bir fotoğrafı, geri kalanını olduğu gibi koruyarak metin talimatıyla düzenlemek ya da yeniden tarzlamak - Referans tabanlı üretim: 10’a kadar görselden stil, kimlik ya da ürün ayrıntılarını aktarmak - Birkaç ürünü, kişiyi ya da sahneyi tek bir görselde birleştirmek - Mevcut bir görselde nesne eklemek, kaldırmak ya da değiştirmek

## Şu durumlarda başka bir model seçin - Referans görseliniz yoksa ve yalnızca prompt’tan üretmek istiyorsanız — `bytedance/seedream-v5/text-to-image` kullanın - En yüksek düzenleme sadakati ya da 2K altında çıktı gerekiyorsa — `bytedance/seedream-v5-pro/edit` kullanın - 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 açıkça belirtin - Bu kademede referans görseller ücretsizdir — fiyatı etkilemeden 10’a kadar görsel ekleyin - `size` hem çözünürlüğü hem en-boy oranını belirler. Her seçenek 2K sınıfıdır; bu kademe daha küçük görsel üretmez. İstenmeyen kırpmayı önlemek için en-boy oranını kaynak görselinize göre 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/edit", { input: { prompt: "replace the background with a sunlit studio, keep the subject unchanged", image_urls: ["https://media.modelrunner.ai/example-photo.jpg"], size: "2048x2048", }, }); ```