Ugrás a tartalomhoz
PlaygroundDokumentációAPI-kulcs igénylése

Mage API · Képmodell

Seedream API

Seedream, szigorú szűrővel

API-kulcs kérésePróbáld ki a Seedream-et a playgroundban
POST https://api.mage.space/v1/seedream/generate

Dióhéjban

A Seedream API a Seedream 5.5-öt és 5 másik változatot futtatja a Mage-en keresztül a POST https://api.mage.space/v1/seedream/generate végponton. Egy alapbeállításokkal indított kérés 42 Gembe kerül (kb. 0,042 $), előfizetés nélkül. A Seedream használja a mentett karaktereket és a hivatkozásokat is, amelyeket a promptban @handle formában adhatsz meg.

  • KépKimenet
  • 6Variánsok
  • 42Gem képenként, alapértelmezett
  • $0.042Körülbelül, USD-ben

Áttekintés

Mire jó a Seedream API

A ByteDance Seedream modellje a vázlatokhoz való Seedream 5.0 Flash-től a Seedream 5.5-ig, amely a legújabb és az alapértelmezett: részletgazdag jelenetekkel, olvasható szöveggel és akár 10 referenciából vagy Characters elemből készített szerkesztésekkel, a Seedream 4.5-ön akár 4K-ig. Szigorú szűrő: a promptokat és az első képeket minden futtatás előtt ellenőrizzük.

A ByteDance Seedream képgenerátor-családja részletgazdag jelenetekhez, olvasható szövegekhez és szerkesztésekhez, akár 10 referenciából vagy Charactersből: Seedream 5.5 (`seedream-5.5`), a legújabb és az alapértelmezett, valósághűbb képekkel, élesebb apró szöveggel és kiszámíthatóbb ismételt szerkesztéssel; Seedream 5.0 Pro (`seedream-5.0-pro`), az előző zászlóshajó; Seedream 5.0 Flash (`seedream-5.0-flash`), egységes ár a bemeneti képekkel együtt, 2K felbontásnál vagy bemeneti képekkel ez a legolcsóbb (egy önálló 1K-s prompt esetén a Seedream 5.5 olcsóbb); Seedream 5.0 Lite (`seedream-5.0-lite`), legfeljebb 3K; Seedream 4.5 (`seedream-4.5`), legfeljebb 4K; és Seedream 4.0 (`seedream-4.0`). Szigorú szűrő: a Mage a futtatás előtt ellenőrzi a promptot és az első képet; az elutasított kérés `content_blocked` hibával és indoklással meghiúsul, a költségét pedig visszatérítjük.

Bemenetként az image és az additional_images mezőket fogadja.

Gyors kezdés

A Seedream API hívása

Állítsd be a MAGE_API_KEY-t, küldd el a kérést a /seedream/generate végpontra, és kérdezd le a status_url-t, amíg a kérés le nem fut.

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

Modellek

Seedream model_id értékek

Küldj model_id-t a változat kiválasztásához. Ha nincs megadva, az alapértelmezett fut.

model_idNévAlapértelmezett
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.5Igen

Beállítások

Seedream paraméterek

Az összes változatra megengedett értékek; egy változat kevesebbet kínálhat. A dokumentáció változatonként felsorolja a lehetőségeket.

MezőÉrtékek
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Bemenetek

A Seedream által elfogadott médiabemenetek

Mindegyiket küldheted https URL-ként, data URL-ként vagy legfeljebb 100 MB-os feltöltésként.

MezőSzerep
imageA referenciakép.
additional_imagesTovábbi referenciaképek.

További képmodellek

További képgeneráló API-k a Mage-en

GYIK

Gyakran ismételt kérdések

Mennyibe kerül a Seedream API?
Egy alapbeállításokkal indított Seedream-kérés (Seedream 5.5) 42 Gembe kerül, ez kb. 0,042 $. Más felbontások, hosszok és változatok módosítják az árat; a válasz a pontos költséget is megadja. A sikertelen generálás költségét visszatérítjük; azt viszont nem, amelyet a Mage tartalmi szabályzata blokkol.
Mi a Seedream API végpontja?
POST https://api.mage.space/v1/seedream/generate Authorization: Bearer fejléccel, amely a Mage API-kulcsodat tartalmazza. A válasz tartalmaz egy status_url-t, amelyet lekérdezve megkapod az eredményt.
Mely Seedream modelleket hívhatom meg?
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). Az alapértelmezett a Seedream 5.5.
Támogatja a Seedream a referenciaképeket vagy a karaktereket?
A Seedream elfogadja: image, additional_images. A Seedream a mentett karaktereket és referenciákat a promptban megadott @handle alapján veszi át.
Használhatom a Seedream-et Claude-ból vagy ChatGPT-ből?
Igen. Csatlakoztasd a Mage MCP-szervert a Claude-hoz, a ChatGPT-hez, a Claude Code-hoz, a Grokhoz vagy a Cursorhoz, és kérd név szerint a Seedream-et. Az asszisztensed a get_model segítségével olvassa ki a beállításait, és generálás előtt megmondja az árat.
Mennyi ideig őrződnek meg a Seedream eredményei?
Az eredményeket és a bemeneteket 30 napig őrizzük. Amit meg szeretnél tartani, töltsd le a saját tárhelyedre.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.

API-kulcs kérésePróbáld ki a Seedream-et a playgroundban