Langsung ke konten

Mage API · Model gambar

Z-Image API

Model gambar tercepat di Mage

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

Sekilas info

Z-Image API menjalankan Z-Image lewat Mage di POST https://api.mage.space/v1/z_image/generate. Satu permintaan dengan pengaturan default dikenai biaya 10 Gems (sekitar $0,01), tanpa langganan. Z-Image tidak mendukung penyebutan @handle.

  • GambarOutput
  • 1Varian
  • 10Gems per gambar, default
  • $0.01Perkiraan, dalam USD

Ringkasan

Apa yang bisa dilakukan Z-Image API

Super cepat dan hemat Gems. Text-to-image fotorealistis dengan anatomi yang solid dan tulisan yang rapi, hingga 2K; tanpa gambar referensi.

Model gambar tercepat di Mage: text-to-image fotorealistis dengan anatomi dan tulisan yang solid, dalam 1K atau 2K.

Gambar dibuat hanya dari prompt.

Mulai cepat

Panggil Z-Image API

Setel MAGE_API_KEY, kirim ke /z_image/generate, lalu poll status_url sampai permintaan selesai.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_image/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": "z-image-turbo"
}' | 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('z_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'z-image-turbo',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("z_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "z-image-turbo",
})

print(request["result"]["url"])

Model

Nilai model_id Z-Image

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

model_idNamaDefault
z-image-turboZ-ImageYa

Opsi

Parameter Z-Image

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
resolution1k, 2k

Model gambar lainnya

API pembuat gambar lainnya di Mage

  • Gambar · mulai 20 Gems

    Anima API

    Dibuat khusus untuk anime

  • Gambar · mulai 35 Gems

    Chroma API

    Open-weights, dibangun di atas Flux

  • Gambar · mulai dari 40 Gems

    Flux 2 API

    Prompt panjang dan edit dengan banyak referensi

  • Gambar · mulai dari 9 Gems

    GPT Image 2 API

    Prompt yang presisi dan teks yang terbaca jelas

  • Gambar · mulai 90 Gems

    Grok Image API

    Grok Imagine, dalam dua tingkatan

  • Gambar · mulai dari 37 Gems

    Guava API

    Fotorealisme yang tampak seperti foto asli

FAQ

Pertanyaan yang sering diajukan

Berapa biaya Z-Image API?
Satu permintaan Z-Image dengan pengaturan default (Z-Image) dikenai biaya 10 Gems, sekitar $0,01. Resolusi, durasi, dan varian lain bisa mengubah harga; biaya pastinya tercantum di respons. Generasi yang gagal akan dikembalikan Gems-nya, tetapi yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint Z-Image API?
POST https://api.mage.space/v1/z_image/generate dengan header Authorization: Bearer yang berisi API key Mage-mu. Respons menyertakan status_url yang bisa kamu poll untuk mendapatkan hasilnya.
Model Z-Image apa saja yang bisa kupanggil?
z-image-turbo (Z-Image). Defaultnya adalah Z-Image.
Apakah Z-Image mendukung gambar referensi atau karakter?
Z-Image tidak menerima input image, video, atau audio. Z-Image tidak mendukung penyebutan @handle.
Bisakah aku memakai Z-Image dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Z-Image dengan menyebut namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harganya sebelum membuat.
Berapa lama hasil Z-Image 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