Ga naar de inhoud
PlaygroundDocumentatieAPI-sleutel aanvragen

Mage API · Beeldmodel

Seedream API

Seedream, met een strikt filter

Vraag een API-sleutel aanProbeer Seedream in de playground
POST https://api.mage.space/v1/seedream/generate

In één oogopslag

De Seedream API draait Seedream 5.5 en 5 andere varianten via Mage op POST https://api.mage.space/v1/seedream/generate. Een verzoek met de standaardinstellingen kost 42 Gems (ongeveer $0,042), zonder abonnement. Seedream ondersteunt opgeslagen personages en referenties via @handle in de prompt.

  • AfbeeldingUitvoer
  • 6Varianten
  • 42Gems per afbeelding, standaard
  • $0.042Ongeveer, in USD

Overzicht

Wat de Seedream API doet

Seedream van ByteDance, van Seedream 5.0 Flash voor concepten tot Seedream 5.5, de nieuwste en de standaard, met gedetailleerde scènes, leesbare tekst en bewerkingen vanuit maximaal 10 referenties of Characters, tot 4K op Seedream 4.5. Strikt filter: prompts en eerste afbeeldingen worden vóór elke run gecontroleerd.

De Seedream-afbeeldingsfamilie van ByteDance, voor gedetailleerde scènes, leesbare tekst en bewerkingen met maximaal 10 referenties of Characters: Seedream 5.5 (`seedream-5.5`), de nieuwste en de standaardkeuze, met realistischere afbeeldingen, scherpere kleine tekst en stabielere herhaalde bewerkingen; Seedream 5.0 Pro (`seedream-5.0-pro`), het vorige vlaggenschip; Seedream 5.0 Flash (`seedream-5.0-flash`), één vaste prijs inclusief invoerafbeeldingen, de laagste bij 2K of met invoerafbeeldingen (Seedream 5.5 is goedkoper voor alleen een prompt in 1K); Seedream 5.0 Lite (`seedream-5.0-lite`), tot 3K; Seedream 4.5 (`seedream-4.5`), tot 4K; en Seedream 4.0 (`seedream-4.0`). Strikt filter: Mage controleert de prompt en de eerste afbeelding voordat de run start; een verzoek dat wordt geweigerd mislukt met `content_blocked` en een reden, en wordt terugbetaald.

Accepteert image, additional_images als invoer.

Snel starten

De Seedream API aanroepen

Stel MAGE_API_KEY in, verstuur je verzoek naar /seedream/generate en poll status_url tot het verzoek is voltooid.

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

Modellen

Seedream model_id-waarden

Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.

model_idNaamStandaard
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.5Ja

Opties

Seedream-parameters

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

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

Invoer

Mediainvoer die Seedream accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

VeldRol
imageDe referentieafbeelding.
additional_imagesExtra referentieafbeeldingen.

Meer beeldmodellen

Andere API's voor beeldgeneratie op Mage

FAQ

Veelgestelde vragen

Hoeveel kost de Seedream API?
Een Seedream-verzoek met de standaardinstellingen (Seedream 5.5) kost 42 Gems, ongeveer $0,042. Andere resoluties, duur en varianten veranderen de prijs; in het antwoord staat het exacte bedrag. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de Seedream API?
POST https://api.mage.space/v1/seedream/generate met een Authorization: Bearer-header met je Mage API-sleutel. Het antwoord bevat een status_url die je pollt voor het resultaat.
Welke Seedream-modellen kan ik aanroepen?
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). De standaard is Seedream 5.5.
Ondersteunt Seedream referentieafbeeldingen of personages?
Seedream accepteert image, additional_images. Seedream accepteert opgeslagen personages en referenties via @handle in de prompt.
Kan ik Seedream gebruiken vanuit Claude of ChatGPT?
Ja. Verbind de Mage MCP-server met Claude, ChatGPT, Claude Code, Grok of Cursor en vraag bij naam om Seedream. Je assistent leest de opties met get_model en noemt de prijs voordat hij genereert.
Hoe lang worden Seedream-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

Vraag een API-sleutel aanProbeer Seedream in de playground