Zum Inhalt springen
PlaygroundDokuAPI-Schlüssel holen

Mage API · Bildmodell

Seedream API

Seedream, mit strengem Filter

API-Schlüssel holenSeedream im Playground ausprobieren
POST https://api.mage.space/v1/seedream/generate

Auf einen Blick

Die Seedream API führt Seedream 5.5 und 5 weitere Varianten über Mage aus, und zwar unter POST https://api.mage.space/v1/seedream/generate. Eine Anfrage mit den Standardeinstellungen kostet 42 Gems (etwa 0,042 $), ohne Abo. Seedream unterstützt gespeicherte Characters und References per @handle im Prompt.

  • BildAusgabe
  • 6Varianten
  • 42Gems pro Bild, Standard
  • $0.042Ca. in USD

Überblick

Was die Seedream API kann

Seedream von ByteDance, von Seedream 5.0 Flash für Entwürfe bis Seedream 5.5, das neueste und der Standard, mit detailreichen Szenen, lesbarem Text und Bearbeitungen aus bis zu 10 Referenzen oder Characters, bis zu 4K mit Seedream 4.5. Strenger Filter: Prompts und erste Bilder werden vor jedem Durchlauf geprüft.

Die Seedream-Bildfamilie von ByteDance für detailreiche Szenen, lesbaren Text und Bearbeitungen mit bis zu 10 References oder Characters: Seedream 5.5 (`seedream-5.5`), das neueste Modell und der Standard, mit realistischeren Bildern, klarerem Kleintext und stabileren wiederholten Bearbeitungen; Seedream 5.0 Pro (`seedream-5.0-pro`), das bisherige Flaggschiff; Seedream 5.0 Flash (`seedream-5.0-flash`), ein Pauschalpreis inklusive Eingabebildern, bei 2K oder mit Eingabebildern der niedrigste (Seedream 5.5 kostet bei einem reinen 1K-Prompt weniger); Seedream 5.0 Lite (`seedream-5.0-lite`), bis zu 3K; Seedream 4.5 (`seedream-4.5`), bis zu 4K; und Seedream 4.0 (`seedream-4.0`). Strenger Filter: Mage prüft den Prompt und das erste Bild vor dem Lauf; eine Anfrage, die abgelehnt wird, schlägt mit `content_blocked` und einer Begründung fehl und wird erstattet.

Es akzeptiert image und additional_images als Eingaben.

Schnellstart

Die Seedream API aufrufen

Setze MAGE_API_KEY, sende die Anfrage an /seedream/generate und frage status_url ab, bis die Anfrage abgeschlossen ist.

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

Modelle

model_id-Werte für Seedream

Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.

model_idNameStandard
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

Optionen

Seedream-Parameter

Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.

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

Eingaben

Medieneingaben, die Seedream akzeptiert

Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.

FeldRolle
imageDas Referenzbild.
additional_imagesWeitere Referenzbilder.

Weitere Bildmodelle

Weitere APIs zur Bildgenerierung auf Mage

FAQ

Häufig gestellte Fragen

Was kostet die Seedream API?
Eine Seedream-Anfrage mit den Standardeinstellungen (Seedream 5.5) kostet 42 Gems, etwa 0,042 $. Andere Auflösungen, Längen und Varianten verändern den Preis; die genauen Kosten stehen in der Antwort. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte dagegen nicht.
Wie lautet der Endpunkt der Seedream API?
POST https://api.mage.space/v1/seedream/generate mit einem Authorization: Bearer-Header, der deinen Mage-API-Schlüssel enthält. Die Antwort enthält eine status_url, die du für das Ergebnis abfragst.
Welche Seedream-Modelle kann ich aufrufen?
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). Der Standard ist Seedream 5.5.
Unterstützt Seedream Referenzbilder oder Characters?
Seedream akzeptiert image und additional_images. Seedream akzeptiert gespeicherte Characters und References per @handle im Prompt.
Kann ich Seedream in Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage-MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frag Seedream einfach beim Namen an. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er generiert.
Wie lange werden Seedream-Ergebnisse gespeichert?
Ergebnisse und Eingaben werden 30 Tage lang gespeichert. Lade alles, was du behalten möchtest, in deinen eigenen Speicher herunter.

Starte jetzt mit Mage

Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.

API-Schlüssel holenSeedream im Playground ausprobieren