Treci la conținut
PlaygroundDocumentațieObține cheia API

Mage API · Model de imagine

API Seedream

Seedream, cu filtru strict

Obține o cheie APIÎncearcă Seedream în playground
POST https://api.mage.space/v1/seedream/generate

Pe scurt

API-ul Seedream rulează Seedream 5.5 și alte 5 variante prin Mage la POST https://api.mage.space/v1/seedream/generate. O solicitare cu setările implicite costă 42 de Gems (aproximativ 0,042 $), fără abonament. Seedream acceptă personaje salvate și referințe prin @handle în prompt.

  • ImagineRezultat
  • 6Variante
  • 42Gems per imagine, implicit
  • $0.042Aproximativ, în USD

Prezentare generală

Ce face API-ul Seedream

Seedream de la ByteDance, de la Seedream 5.0 Flash pentru schițe până la Seedream 5.5, cel mai nou și cel implicit, cu scene detaliate, text lizibil și editări din până la 10 referințe sau Characters, până la 4K pe Seedream 4.5. Filtru strict: prompt-urile și primele imagini sunt verificate înainte de fiecare rulare.

Familia de modele de imagini Seedream de la ByteDance, pentru scene detaliate, text lizibil și editări pornind de la până la 10 referințe sau Characters: Seedream 5.5 (`seedream-5.5`), cel mai nou și cel implicit, cu imagini mai realiste, text mic mai clar și editări repetate mai stabile; Seedream 5.0 Pro (`seedream-5.0-pro`), fostul model de top; Seedream 5.0 Flash (`seedream-5.0-flash`), un preț fix, cu imaginile de intrare incluse, cel mai mic la 2K sau cu imagini de intrare (Seedream 5.5 costă mai puțin pentru un prompt de 1K fără imagini); Seedream 5.0 Lite (`seedream-5.0-lite`), până la 3K; Seedream 4.5 (`seedream-4.5`), până la 4K; și Seedream 4.0 (`seedream-4.0`). Filtru strict: Mage verifică promptul și prima imagine înainte de generare; o cerere refuzată eșuează cu `content_blocked` și un motiv, iar costul îți este rambursat.

Acceptă ca intrări image, additional_images.

Pornire rapidă

Apelează API-ul Seedream

Setează MAGE_API_KEY, trimite cererea la /seedream/generate și interoghează status_url până când cererea se finalizează.

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

Modele

Valorile model_id pentru Seedream

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
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.5Da

Opțiuni

Parametrii Seedream

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Intrări

Fișiere media acceptate de Seedream

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Seedream?
O solicitare Seedream cu setările implicite (Seedream 5.5) costă 42 de Gems, adică aproximativ 0,042 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Seedream?
POST https://api.mage.space/v1/seedream/generate cu un antet Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru a obține rezultatul.
Ce modele Seedream pot apela?
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). Cel implicit este Seedream 5.5.
Acceptă Seedream imagini de referință sau personaje?
Seedream acceptă image, additional_images. Seedream acceptă personaje salvate și referințe prin @handle în prompt.
Pot folosi Seedream din Claude sau ChatGPT?
Da. Conectează serverul MCP Mage la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Seedream pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Seedream?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.

Obține o cheie APIÎncearcă Seedream în playground