Treci la conținut
PlaygroundDocumentațieObține cheia API

Mage API · Model de imagine

API HiDream

Rapid și versatil, cu prompturi negative

Obține o cheie APIÎncearcă HiDream în playground
POST https://api.mage.space/v1/hidream/generate

Pe scurt

API-ul HiDream rulează HiDream prin Mage la POST https://api.mage.space/v1/hidream/generate. O cerere cu setările implicite costă 20 Gems (aproximativ $0.02), fără abonament. HiDream nu acceptă mențiuni @handle.

  • ImagineRezultat
  • 1Variantă
  • 20Gems per imagine, implicit
  • $0.02Aproximativ, în USD

Prezentare generală

Ce face API-ul HiDream

Un model rapid și general de generare de imagini din text, cu prompt negativ. Excelent pentru prompturi de zi cu zi, fotorealiste sau ilustrate.

Un model general rapid de imagini, cu prompt negativ, fotorealist sau ilustrat.

Generează doar pe baza promptului.

Pornire rapidă

Apelează API-ul HiDream

Setează MAGE_API_KEY, trimite cererea la /hidream/generate și interoghează status_url până când cererea se finalizează.

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

Modele

Valori model_id pentru HiDream

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
hidream-fastHiDreamDa

Opțiuni

Parametri HiDream

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul HiDream?
O cerere HiDream cu setările implicite (HiDream) costă 20 Gems, adică aproximativ $0.02. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului HiDream?
POST https://api.mage.space/v1/hidream/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru rezultat.
Ce modele HiDream pot apela?
hidream-fast. Implicit este HiDream.
Acceptă HiDream imagini de referință sau personaje?
HiDream nu acceptă intrări de tip imagine, video sau audio. HiDream nu acceptă mențiuni @handle.
Pot folosi HiDream din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere HiDream pe nume. Asistentul tău își citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele HiDream?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.

Obține o cheie APIÎncearcă HiDream în playground