Zum Inhalt springen

Mage API · Bildmodell

HiDream API

Schnell und vielseitig, mit Negativ-Prompts

POST https://api.mage.space/v1/hidream/generate

Auf einen Blick

Die HiDream API führt HiDream über Mage aus, und zwar unter POST https://api.mage.space/v1/hidream/generate. Eine Anfrage mit den Standardeinstellungen kostet 20 Gems (etwa 0,02 $), ohne Abo. HiDream unterstützt keine @handle-Erwähnungen.

  • BildAusgabe
  • 1Variante
  • 20Gems pro Bild, Standard
  • $0.02Ca. in USD

Überblick

Was die HiDream API kann

Ein schnelles, vielseitiges Text-zu-Bild-Modell mit Negativ-Prompt. Ideal für Alltags-Prompts, ob fotorealistisch oder illustriert.

Ein schnelles, vielseitiges Bildmodell mit Negativ-Prompt, fotorealistisch oder illustriert.

Es generiert allein anhand des Prompts.

Schnellstart

Die HiDream API aufrufen

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/hidream/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": "hidream-fast"
}' | 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('hidream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'hidream-fast',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("hidream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "hidream-fast",
})

print(request["result"]["url"])

Modelle

HiDream model_id-Werte

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

model_idNameStandard
hidream-fastHiDreamJa

Optionen

HiDream-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

Weitere Bildmodelle

Weitere APIs zur Bildgenerierung auf Mage

  • Bild · ab 20 Gems

    Krea 2 API

    Beeindruckende Ästhetik in Sekunden

  • Bild · ab 42 Gems

    Mango API

    Unsere Flaggschiff-Bildfamilie

  • Bild · ab 15 Gems

    MiniMax H3 Image API

    Native 16-Megapixel-Bilder, Open Weights

  • Bild · ab 25 Gems

    MOSS-Image API

    Lange Prompts und zweisprachiger Text, offene Gewichte

  • Bild · ab 51 Gems

    Nano Banana 2 API

    Gestochen scharfer, lesbarer Text, bis zu 4K

  • Bild · ab 15 Gems

    SDXL Plus API

    SDXL mit korrigierten Gesichtern und Händen

FAQ

Häufig gestellte Fragen

Wie viel kostet die HiDream API?
Eine HiDream-Anfrage mit den Standardeinstellungen (HiDream) kostet 20 Gems, etwa 0,02 $. Andere Auflösungen, Dauern und Varianten verändern den Preis; die Antwort nennt den genauen Betrag. Eine fehlgeschlagene Generierung wird erstattet; eine, die von der Inhaltsrichtlinie von Mage blockiert wird, nicht.
Wie lautet der Endpunkt der HiDream API?
POST https://api.mage.space/v1/hidream/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 HiDream-Modelle kann ich aufrufen?
hidream-fast. Standard ist HiDream.
Unterstützt HiDream Referenzbilder oder Characters?
HiDream akzeptiert keine Bild-, Video- oder Audioeingaben. HiDream unterstützt keine @handle-Erwähnungen.
Kann ich HiDream über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage-MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frag direkt nach HiDream. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er generiert.
Wie lange werden HiDream-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.

CharactersCommunity