İçeriğe geç

Mage API · Görsel modeli

HiDream API

Hızlı ve çok yönlü, negatif istem destekli

POST https://api.mage.space/v1/hidream/generate

Bir bakışta

HiDream API, HiDream'i Mage üzerinden POST https://api.mage.space/v1/hidream/generate adresinde çalıştırır. Varsayılan ayarlarla bir istek 20 Gems (yaklaşık 0,02 $) tutar, abonelik gerekmez. HiDream @handle etiketlerini desteklemez.

  • GörselÇıktı
  • 1Varyant
  • 20Görsel başına Gems, varsayılan
  • $0.02Yaklaşık, USD

Genel bakış

HiDream API ne yapar?

Negatif istem destekli, hızlı ve genel amaçlı bir metinden görsele modeli. Fotogerçekçi ya da çizim tarzı gündelik istemler için harika.

Negatif istem destekli, hızlı ve genel amaçlı bir görsel modeli; fotogerçekçi veya çizim tarzı.

Yalnızca prompttan görsel üretir.

Hızlı başlangıç

HiDream API'sini çağır

MAGE_API_KEY'i ayarla, /hidream/generate adresine gönder ve istek tamamlanana kadar status_url adresini yokla.

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

Modeller

HiDream model_id değerleri

Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.

model_idAdVarsayılan
hidream-fastHiDreamEvet

Seçenekler

HiDream parametreleri

Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.

AlanDeğerler
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Daha fazla görsel modeli

Mage'deki diğer görsel üretim API'leri

  • Görsel · 20 Gem'den başlayan fiyatlarla

    Krea 2 API

    Saniyeler içinde muhteşem estetik

  • Görsel · 42 Gem'den başlayan fiyatlarla

    Mango API

    Amiral gemisi görsel model ailemiz

  • Görsel · 15 Gems'ten başlayan fiyatlarla

    MiniMax H3 Image API

    Yerel 16 megapiksel görseller, açık ağırlıklar

  • Görsel · 25 Gems'den başlayan fiyatlarla

    MOSS-Image API

    Uzun prompt'lar ve iki dilli metin, açık ağırlıklar

  • Görsel · 51 Gems'ten başlayan fiyatlarla

    Nano Banana 2 API

    Net, okunaklı metin, 4K'ya kadar

  • Görsel · 15 Gems'ten başlayan fiyatlarla

    SDXL Plus API

    Yüzleri ve elleri düzeltilmiş SDXL

SSS

Sık sorulan sorular

HiDream API'sinin maliyeti ne kadar?
Varsayılan ayarlarla (HiDream) bir HiDream isteği 20 Gems, yani yaklaşık 0,02 $ tutar. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta bildirilir. Başarısız olan üretimin ücreti iade edilir; Mage'in içerik politikası nedeniyle engellenen üretimin ücreti ise iade edilmez.
HiDream API uç noktası nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/hidream/generate. Yanıt, sonucu yoklamak için bir status_url içerir.
Hangi HiDream modellerini çağırabilirim?
hidream-fast. Varsayılan model HiDream.
HiDream referans görsellerini veya karakterleri destekliyor mu?
HiDream görsel, video veya ses girdisi almaz. @handle etiketlerini de desteklemez.
HiDream'i Claude veya ChatGPT'den kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve HiDream'i adıyla iste. Asistanın seçenekleri get_model ile okur ve üretmeden önce fiyatı söyler.
HiDream sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

CharactersTopluluk