Přeskočit na obsah
PlaygroundDokumentaceZískat API klíč

Mage API · Model pro obrázky

HiDream API

Rychlé a univerzální, s negativními prompty

Získat API klíčVyzkoušej HiDream v playgroundu
POST https://api.mage.space/v1/hidream/generate

Stručně

HiDream API spouští HiDream přes Mage na POST https://api.mage.space/v1/hidream/generate. Požadavek s výchozím nastavením stojí 20 Gems (asi 0,02 $), bez předplatného. HiDream nepodporuje zmínky přes @handle.

  • ObrázekVýstup
  • 1Varianta
  • 20Gems za obrázek, výchozí
  • $0.02Přibližně v USD

Přehled

Co umí HiDream API

Rychlý univerzální model pro převod textu na obrázek s negativním promptem. Skvělý na běžné prompty, fotorealistické i ilustrované.

Rychlý univerzální obrázkový model s negativním promptem, fotorealistický i ilustrovaný.

Generuje pouze z promptu.

Rychlý start

Volání HiDream API

Nastav MAGE_API_KEY, odešli požadavek na /hidream/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro HiDream

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
hidream-fastHiDreamAno

Možnosti

Parametry HiDream

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Další modely pro obrázky

Další API pro generování obrázků na Mage

Časté dotazy

Často kladené otázky

Kolik stojí HiDream API?
Požadavek na HiDream ve výchozím nastavení (HiDream) stojí 20 Gems, tedy asi 0,02 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku uvádí odpověď. Za neúspěšné generování dostaneš Gems zpět; za generování zablokované zásadami obsahu Mage ne.
Jaký je endpoint HiDream API?
POST https://api.mage.space/v1/hidream/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém se dotazuješ na výsledek.
Které modely HiDream můžu volat?
hidream-fast. Výchozí je HiDream.
Podporuje HiDream referenční obrázky nebo postavy?
HiDream nepřijímá obrázkové, video ani zvukové vstupy. HiDream nepodporuje zmínky přes @handle.
Můžu používat HiDream z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o HiDream jeho názvem. Tvůj asistent si přečte jeho možnosti přes get_model a před generováním uvede cenu.
Jak dlouho se výsledky HiDream uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.

Získat API klíčVyzkoušej HiDream v playgroundu