Mage API · Görsel modeli

Z-Image API

Mage'in en hızlı görsel modeli

API anahtarı alZ-Image'ı playground'da dene
POST https://api.mage.space/v1/z_image/generate

Bir bakışta

Z-Image API, Z-Image modelini Mage üzerinden POST https://api.mage.space/v1/z_image/generate adresinde çalıştırır. Varsayılan ayarlardaki bir istek 10 Gems (yaklaşık 0,01 $) tutarındadır ve abonelik gerekmez. Z-Image @handle etiketlerini desteklemez.

Genel bakış

Z-Image API ne yapar?

Çok hızlı ve Gems dostu. Sağlam anatomi ve temiz yazılarla fotogerçekçi metinden görsele üretim, 2K'ya kadar; referans görseli yok.

Mage'in en hızlı görsel modeli: 1K veya 2K çözünürlükte, sağlam anatomi ve net yazılarla fotogerçekçi metinden görsele üretim.

Yalnızca prompttan görsel üretir.

Hızlı başlangıç

Z-Image API'yi çağır

MAGE_API_KEY'i ayarla, isteği /z_image/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.

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

Modeller

Z-Image 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
z-image-turboZ-ImageEvet

Seçenekler

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

Daha fazla görsel modeli

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

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

Anima API

Özellikle anime için geliştirildi

Görsel · 35 Gem'den başlayan fiyatlarla

Chroma API

Açık ağırlıklı, Flux tabanlı

Görsel · 40 Gem'den başlayan fiyatlarla

Flux 2 API

Uzun prompt'lar ve çoklu referanslı düzenlemeler

Görsel · 9 Gem'den başlayan fiyatlarla

GPT Image 2 API

Hassas prompt'lar ve okunaklı metin

Görsel · 75 Gem'den başlayan fiyatlarla

Grok Image API

Grok Imagine, üç kalite seviyesiyle

Görsel · 37 Gem'den başlayan fiyatlarla

Guava API

Fotoğraf sanılacak kadar gerçekçi görseller

SSS

Sık sorulan sorular

Z-Image API'nin maliyeti nedir?

Varsayılan ayarlarda (Z-Image) bir Z-Image isteği 10 Gems tutarındadır, yani yaklaşık 0,01 $. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta gösterilir. Başarısız olan bir üretimin ücreti iade edilir; Mage'in içerik politikası nedeniyle engellenen üretimin ücreti iade edilmez.

Z-Image API uç noktası nedir?

Mage API anahtarını içeren bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/z_image/generate adresine istek gönder. Yanıt, sonucu sorgulamak için bir status_url içerir.

Hangi Z-Image modellerini çağırabilirim?

z-image-turbo (Z-Image). Varsayılan model Z-Image'dır.

Z-Image referans görselleri veya karakterleri destekliyor mu?

Z-Image görsel, video veya ses girişi kabul etmez. Z-Image @handle etiketlerini desteklemez.

Z-Image'ı Claude veya ChatGPT üzerinden kullanabilir miyim?

Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Z-Image'ı adıyla iste. Asistanın seçeneklerini get_model ile okur ve üretmeden önce fiyatı söyler.

Z-Image 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.

API anahtarı alZ-Image'ı playground'da dene

İlgili