Přeskočit na obsah
PlaygroundDokumentaceZískat API klíč

Mage API · Model pro obrázky

Seedream API

Seedream se striktním filtrem

Získat API klíčVyzkoušej Seedream v playgroundu
POST https://api.mage.space/v1/seedream/generate

Stručně

Seedream API spouští přes Mage model Seedream 5.5 a 5 dalších variant na POST https://api.mage.space/v1/seedream/generate. Požadavek s výchozím nastavením stojí 42 Gems (asi 0,042 $), bez předplatného. Seedream umí pracovat s uloženými postavami (Characters) a referencemi pomocí @handle v promptu.

  • ObrázekVýstup
  • 6Varianty
  • 42Gems za obrázek, výchozí
  • $0.042Přibližně v USD

Přehled

Co umí Seedream API

Seedream od ByteDance, od Seedream 5.0 Flash pro návrhy až po Seedream 5.5, nejnovější a výchozí model s detailními scénami, čitelným textem a úpravami až z 10 referencí nebo Characters, až do 4K u Seedream 4.5. Přísný filtr: prompty a první obrázky se kontrolují před každým spuštěním.

Rodina obrazových modelů Seedream od ByteDance pro detailní scény, čitelný text a úpravy až z 10 referencí nebo Characters: Seedream 5.5 (`seedream-5.5`), nejnovější a výchozí model, s realističtějšími obrázky, čitelnějším drobným textem a stabilnějšími opakovanými úpravami; Seedream 5.0 Pro (`seedream-5.0-pro`), předchozí vlajková loď; Seedream 5.0 Flash (`seedream-5.0-flash`), jedna pevná cena včetně vstupních obrázků, nejnižší v 2K nebo se vstupními obrázky (Seedream 5.5 vyjde levněji u samotného promptu v 1K); Seedream 5.0 Lite (`seedream-5.0-lite`), až do 3K; Seedream 4.5 (`seedream-4.5`), až do 4K; a Seedream 4.0 (`seedream-4.0`). Přísný filtr: Mage zkontroluje prompt a první obrázek před spuštěním; požadavek, který zamítne, skončí chybou `content_blocked` s uvedením důvodu a peníze se vrátí.

Jako vstupy přijímá image, additional_images.

Rychlý start

Zavolej Seedream API

Nastav MAGE_API_KEY, odešli požadavek na /seedream/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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"])

Modely

Hodnoty model_id pro Seedream

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
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.5Ano

Možnosti

Parametry Seedream

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Vstupy

Mediální vstupy, které Seedream přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.

Další modely pro obrázky

Další API pro generování obrázků na Mage

Časté dotazy

Často kladené otázky

Kolik stojí Seedream API?
Požadavek na Seedream s výchozím nastavením (Seedream 5.5) stojí 42 Gems, asi 0,042 $. Jiná rozlišení, délky a varianty cenu mění; přesnou cenu najdeš v odpovědi. Neúspěšné generování se vrací zpět, generování zablokované pravidly obsahu Mage ne.
Jaký je endpoint Seedream API?
POST na https://api.mage.space/v1/seedream/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na který se dotazuješ na výsledek.
Které modely Seedream můžu volat?
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). Výchozí je Seedream 5.5.
Podporuje Seedream referenční obrázky nebo postavy?
Seedream přijímá image, additional_images. Umí pracovat s uloženými postavami a referencemi přes @handle v promptu.
Můžu Seedream používat z Claude nebo ChatGPT?
Ano. Připoj MCP server Mage ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Seedream jménem. Tvůj asistent si přečte jeho možnosti přes get_model a před generováním uvede cenu.
Jak dlouho se výsledky Seedream uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.

Získat API klíčVyzkoušej Seedream v playgroundu