Langsung ke konten

Mage API · Model gambar

API HiDream

Cepat dan serbaguna, dengan negative prompt

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

Sekilas info

API HiDream menjalankan HiDream lewat Mage di POST https://api.mage.space/v1/hidream/generate. Satu permintaan dengan pengaturan default berharga 20 Gems (sekitar $0,02), tanpa langganan. HiDream tidak menerima sebutan @handle.

  • GambarOutput
  • 1Varian
  • 20Gems per gambar, default
  • $0.02Perkiraan, dalam USD

Ringkasan

Fungsi API HiDream

Model teks-ke-gambar umum yang cepat dengan negative prompt. Cocok untuk prompt sehari-hari, baik fotorealistis maupun ilustrasi.

Model gambar umum yang cepat dengan negative prompt, fotorealistis atau ilustrasi.

Gambar dibuat hanya dari prompt.

Mulai cepat

Panggil API HiDream

Setel MAGE_API_KEY, kirim ke /hidream/generate, lalu polling status_url sampai permintaan selesai.

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

Model

Nilai model_id HiDream

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

model_idNamaDefault
hidream-fastHiDreamYa

Opsi

Parameter HiDream

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

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

Model gambar lainnya

API pembuat gambar lainnya di Mage

  • Gambar · mulai 20 Gems

    Krea 2 API

    Estetika memukau dalam hitungan detik

  • Gambar · mulai dari 42 Gems

    Mango API

    Keluarga model gambar andalan kami

  • Gambar · mulai dari 15 Gems

    MiniMax H3 Image API

    Gambar native 16 megapiksel, open weights

  • Gambar · mulai dari 25 Gems

    MOSS-Image API

    Prompt panjang dan teks dwibahasa, open weights

  • Gambar · mulai dari 51 Gems

    Nano Banana 2 API

    Teks tajam dan mudah dibaca, hingga 4K

  • Gambar · mulai dari 15 Gems

    API SDXL Plus

    SDXL dengan wajah dan tangan yang sudah diperbaiki

FAQ

Pertanyaan yang sering diajukan

Berapa biaya API HiDream?
Satu permintaan HiDream dengan pengaturan default (HiDream) berharga 20 Gems, sekitar $0,02. Resolusi, durasi, dan varian lain akan mengubah harganya; respons menampilkan biaya pastinya. Generasi yang gagal akan dikembalikan Gems-nya; generasi yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint API HiDream?
POST https://api.mage.space/v1/hidream/generate dengan header Authorization: Bearer yang berisi kunci API Mage kamu. Respons menyertakan status_url untuk di-polling guna mendapatkan hasilnya.
Model HiDream apa saja yang bisa kupanggil?
hidream-fast. Defaultnya adalah HiDream.
Apakah HiDream mendukung gambar referensi atau karakter?
HiDream tidak menerima input gambar, video, atau audio. HiDream tidak menerima sebutan @handle.
Bisakah aku memakai HiDream dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta HiDream dengan menyebut namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harga sebelum membuat.
Berapa lama hasil HiDream disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

CharactersKomunitas