İçeriğe geç
PlaygroundDokümanlarAPI anahtarı al

Mage API · Görsel modeli

Seedream API

Seedream, sıkı filtreyle

API anahtarı alSeedream'i playground'da dene
POST https://api.mage.space/v1/seedream/generate

Bir bakışta

Seedream API, Seedream 5.5 ve 5 diğer varyantı Mage üzerinden POST https://api.mage.space/v1/seedream/generate adresinde çalıştırır. Varsayılan ayarlarla yapılan bir istek 42 Gem (yaklaşık 0,042 $) tutar ve abonelik gerektirmez. Seedream, kayıtlı karakterleri ve istem içinde @handle ile verilen referansları kullanabilir.

  • GörselÇıktı
  • 6Varyantlar
  • 42Görsel başına Gems, varsayılan
  • $0.042Yaklaşık, USD

Genel bakış

Seedream API ne yapar?

ByteDance'in Seedream'i: taslaklar için Seedream 5.0 Flash'tan, en yeni ve varsayılan model Seedream 5.5'e kadar. Detaylı sahneler, okunaklı metinler ve 10'a kadar referans veya Characters'tan düzenlemeler sunar; Seedream 4.5'te 4K'ya kadar çıkar. Sıkı Filtre: prompt'lar ve ilk görseller her çalıştırmadan önce kontrol edilir.

ByteDance'in Seedream görsel modelleri ailesi; ayrıntılı sahneler, okunaklı metinler ve en fazla 10 referans veya Characters ile yapılan düzenlemeler için: Seedream 5.5 (`seedream-5.5`), en yeni ve varsayılan model; daha gerçekçi görseller, daha net küçük yazılar ve daha tutarlı tekrarlı düzenlemeler sunar; Seedream 5.0 Pro (`seedream-5.0-pro`), önceki amiral gemisi model; Seedream 5.0 Flash (`seedream-5.0-flash`), girdi görselleri dahil tek sabit fiyat, 2K'da veya girdi görselleriyle en düşük fiyat (yalnızca prompt kullanılan 1K çıktıda Seedream 5.5 daha ucuzdur); Seedream 5.0 Lite (`seedream-5.0-lite`), 3K'ya kadar; Seedream 4.5 (`seedream-4.5`), 4K'ya kadar; ve Seedream 4.0 (`seedream-4.0`). Sıkı Filtre: Mage, çalıştırmadan önce prompt'u ve ilk görseli kontrol eder; reddettiği bir istek `content_blocked` hatasıyla ve bir gerekçeyle başarısız olur, ücreti iade edilir.

Girdi olarak image, additional_images kabul eder.

Hızlı başlangıç

Seedream API'yi çağır

MAGE_API_KEY'i ayarla, /seedream/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "seedream-5.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "seedream-5.5",
})

print(request["result"]["url"])

Modeller

Seedream model_id değerleri

Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.

model_idAdVarsayılan
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Evet

Seçenekler

Seedream parametreleri

Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.

AlanDeğerler
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Girdiler

Seedream'in kabul ettiği medya girdileri

Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.

AlanRol
imageReferans görsel.
additional_imagesEk referans görseller.

Daha fazla görsel modeli

Mage'deki diğer görsel üretim API'leri

  • Görsel · 10 Gems'ten başlayan fiyatlarla

    Stable Diffusion v1.5 API

    Bütçe dostu klasik

  • Görsel · 10 Gems'ten başlayan fiyatlarla

    Stable Diffusion v3.5 Large API

    Söylediğini en iyi anlayan Stable Diffusion

  • Görsel · 10 Gems'ten başlayan fiyatlarla

    Stable Diffusion XL API

    Fotogerçekçi sonuçlar için ayarlanmış SDXL

  • Görsel · 10 Gems'ten başlayan fiyatlarla

    Z-Image API

    Mage'deki en hızlı görsel modeli

  • Görsel · 20 Gem'den başlayan fiyatlarla

    Anima API

    Özellikle anime için geliştirildi

  • Görsel · 35 Gem'den başlayan fiyatlarla

    Chroma API

    Açık ağırlıklı, Flux tabanlı

SSS

Sık sorulan sorular

Seedream API'nin maliyeti nedir?
Varsayılan ayarlarla (Seedream 5.5) yapılan bir Seedream isteği 42 Gem, yani yaklaşık 0,042 $ tutar. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; yanıtta tam ücret belirtilir. Başarısız olan üretimlerin ücreti iade edilir; Mage'in içerik politikası nedeniyle engellenenlerin ücreti iade edilmez.
Seedream API uç noktası nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/seedream/generate. Yanıt, sonucu sorgulayacağın bir status_url içerir.
Hangi Seedream modellerini çağırabilirim?
seedream-4.0 (Seedream 4.0), seedream-4.5 (Seedream 4.5), seedream-5.0-lite (Seedream 5.0 Lite), seedream-5.0-pro (Seedream 5.0 Pro), seedream-5.0-flash (Seedream 5.0 Flash), seedream-5.5 (Seedream 5.5). Varsayılan model Seedream 5.5'tir.
Seedream referans görsellerini veya karakterleri destekliyor mu?
Seedream image, additional_images kabul eder. Seedream, kayıtlı karakterleri ve referansları prompt içinde @handle ile alır.
Seedream'i Claude veya ChatGPT'den kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Seedream'i adıyla iste. Asistanın seçenekleri get_model ile okur ve üretmeden önce fiyatı söyler.
Seedream sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

API anahtarı alSeedream'i playground'da dene