Mage API · Beeldmodel

HiDream API

Snel en veelzijdig, met negatieve prompts

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

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.

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_idNaamStandaard
hidream-fastHiDreamJa

Opties

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

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.

Vraag een API-sleutel aanProbeer HiDream in de playground

Gerelateerd