In één oogopslag
De HiDream API draait HiDream via Mage op POST https://api.mage.space/v1/hidream/generate. Een verzoek met de standaardinstellingen kost 20 Gems (ongeveer $0,02), zonder abonnement. HiDream ondersteunt geen @handle-vermeldingen.
Afbeelding
Uitvoer
1
Variant
20
Gems per afbeelding, standaard
$0.02
Ongeveer, in USD
Overzicht
Wat de HiDream API doet
Een snel, algemeen tekst-naar-afbeelding-model met een negatieve prompt. Ideaal voor alledaagse prompts, fotorealistisch of geïllustreerd.
Een snel, algemeen afbeeldingsmodel met een negatieve prompt, fotorealistisch of geïllustreerd.
Het genereert alleen op basis van de prompt.
Snel starten
Roep de HiDream API aan
Stel MAGE_API_KEY in, verstuur je verzoek naar /hidream/generate en vraag status_url steeds opnieuw op tot het verzoek is voltooid.
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"])Modellen
model_id-waarden voor HiDream
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| hidream-fast | HiDream | Ja |
Opties
HiDream-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
Meer beeldmodellen
Andere API's voor beeldgeneratie op Mage
Afbeelding · vanaf 20 Gems
Krea 2 API
Prachtige esthetiek in enkele seconden
Afbeelding · vanaf 135 Gems
Mango API
Onze vlaggenschip-afbeeldingsfamilie
Afbeelding · vanaf 68 Gems
Nano Banana 2 API
Scherpe, leesbare tekst, tot 4K
Afbeelding · vanaf 15 Gems
SDXL Plus API
SDXL met gerepareerde gezichten en handen
Afbeelding · vanaf 10 Gems
Stable Diffusion v1.5 API
De klassieker, voor een klein budget
Afbeelding · vanaf 10 Gems
Stable Diffusion v3.5 Large API
De Stable Diffusion die het best luistert
FAQ
Veelgestelde vragen
Wat kost de HiDream API?
Een HiDream-verzoek met de standaardinstellingen (HiDream) kost 20 Gems, ongeveer $0,02. 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 HiDream API?
POST https://api.mage.space/v1/hidream/generate met een Authorization: Bearer-header met je Mage API-sleutel. Het antwoord bevat een status_url waarmee je het resultaat kunt opvragen.
Welke HiDream-modellen kan ik aanroepen?
hidream-fast. De standaard is HiDream.
Ondersteunt HiDream referentieafbeeldingen of Characters?
HiDream accepteert geen afbeeldings-, video- of audio-invoer. HiDream ondersteunt geen @handle-vermeldingen.
Kan ik HiDream gebruiken vanuit Claude of ChatGPT?
Ja. Koppel de Mage MCP-server aan Claude, ChatGPT, Claude Code, Grok of Cursor en vraag om HiDream bij naam. Je assistent leest de opties uit met get_model en noemt de prijs voordat er iets wordt gegenereerd.
Hoe lang worden HiDream-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.