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.
Bild
Ausgabe
1
Variante
20
Gems pro Bild, Standard
$0.02
Ca. 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_id | Name | Standard |
|---|---|---|
| hidream-fast | HiDream | Ja |
Optionen
HiDream-Parameter
Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.
| Feld | Werte |
|---|---|
| aspect_ratio | 21: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 135 Gems
Mango API
Unsere Flaggschiff-Bildfamilie
Bild · ab 68 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
Bild · ab 10 Gems
Stable Diffusion v1.5 API
Der Klassiker für kleines Budget
Bild · ab 10 Gems
Stable Diffusion v3.5 Large API
Das Stable Diffusion, das am besten auf Prompts hört
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.