Z Image API
Ultra-fast text-to-image — photorealistic results in ~1 second with 8 inference steps.
curl -X POST https://runapi.ai/api/v1/z_image/text_to_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "Generate a clean product shot of white sneakers on a gradient background, studio lighting."
}'import { ZImageClient } from "@runapi.ai/z-image";
const client = new ZImageClient();
const result = await client.textToImage.run({
model: "z-image",
prompt: "Generate a clean product shot of white sneakers on a gradient background, studio lighting.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\ZImage\ZImageClient;
$client = new ZImageClient();
$result = $client->textToImage->run([
'model' => 'z-image',
'prompt' => 'Generate a clean product shot of white sneakers on a gradient background, studio lighting.',
]);require "runapi/z_image"
client = RunApi::ZImage::Client.new
result = client.text_to_image.run(
model: "z-image",
prompt: "Generate a clean product shot of white sneakers on a gradient background, studio lighting."
)npx skills add runapi-ai/z-image -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorZ Image is Alibaba's ultra-fast text-to-image model that generates images in approximately 1 second using 8 inference steps. It prioritizes generation speed while maintaining coherent, high-quality outputs.
- Farklı hız / kalite seviyeleri için birden çok varyant
- Model skill dokümanları, şemaları ve kurulum notlarını içerir
- Uygulama odaklı kodlama workflow’larıyla çalışır
- Başarısız üretimler ücretlendirilmez
Fiyatlandırma
Teknik detaylar
| Model ID | z-image |
| Sağlayıcı | Alibaba |
| Modality | image |
| Görev türü | asynchronous |
| Faturalama birimi | call |
| API endpoint | /api/v1/z_image/text_to_image |
| Ticari lisans | Evet — API üzerinden dahil |
| Katalog durumu | Operasyonel |
Uygulama geliştirme için Z Image skill’ini kurun
Model dokümanlarını, şemaları, fiyat notlarını ve kurulum adımlarını kod workspace’inize yükleyin.
# Install the model skill for app development workflows
npx skills add runapi-ai/z-image -gInstall the Z Image skill for this app: 1. Add runapi-ai/z-image with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Model skill’den ilk sonuca dört adımda
Modeli seçin
Çıktı tipi, kalite eşiği ve gecikme hedefinize uygun model ve varyantı seçin.
Yapılandır
RunAPI anahtarınızı ayarlayın ve model skill’i kod workspace’inize kurun.
Geliştirin
Skill talimatlarını kullanarak model özelliğini uygulamanızın içine ekleyin.
Al
Task ID ile sorgulayın, destekleniyorsa stream edin veya webhook callback’i işleyin.
Z Image API nedir?
Z Image is Alibaba's speed-optimized text-to-image model, generating results very fast. Through RunAPI, it shares the same API shape and billing as all Alibaba models.
Z Image API neden RunAPI üzerinden kullanılmalı
Tek kimlik doğrulama, tüm sağlayıcılar
Tek bir RunAPI anahtarı tüm kataloğu açar. Ayrı hesap yok, her entegrasyon için anahtar döndürme yok.
Birleşik fiyatlandırma ve faturalandırma
USD bazında çağrı başı fiyatlandırma, aylık faturalandırılır. Başarısız üretimler ücretlendirilmez.
Şemalı skill
Tipli şemalar ve kurulum notları model skill içinde paketlenir; uygulama doğru kontrattan başlar.
Sık sorulan sorular
How fast is Z Image generation?
Approximately 1 second using 8 inference steps — one of the fastest text-to-image models available.
Is the quality comparable to slower models?
Z Image produces photorealistic, coherent images suitable for production use. For maximum fidelity on complex scenes, consider Qwen 2 or Imagen 4.
What makes Z Image so fast?
Z Image uses a distilled architecture that runs in just 8 inference steps, dramatically reducing generation time while maintaining visual coherence.
What output resolution does Z Image produce?
Standard resolution suitable for web and social media. For higher-resolution needs, pair Z Image with Topaz upscaling.
Is Z Image good for batch generation?
Yes — its speed makes it ideal for high-volume pipelines like e-commerce catalogs, social media assets, and thumbnail generation.
Hangi varyantla başlamalıyım?
Kalite beklentinizi karşılayan en uygun fiyatlı varyantı seçin. Çoğu ekip hızlı varyantla başlar ve üretimde pro sürüme geçer.
Ücretsiz bir katman var mı?
Yeni hesaplar her modelde ilk çağrıları ücretsiz alır. Sonrasında çağrı başına ödeme yaparsınız.
Sonuçları streaming olarak sunuyor musunuz?
Streaming desteklendiğinde RunAPI uçtan uca streaming sağlar.
Başarısız işlemler nasıl ücretlendirilir?
Başarısız üretimler ücretlendirilmez.
Çıktılar önbelleğe alınıyor mu?
Üretilen çıktılar saklanır ve görev ID’siyle geri alınabilir. Girdiler önbelleğe alınmaz.
Ticari kullanım yapabilir miyim?
Evet — bir model lisansı bunu açıkça kısıtlamadıkça ticari kullanım tüm varyantlarda dahildir; kısıtlamalar varyant sayfasında belirtilir.
Oran limitleri ne durumda?
Anahtar bazlı oran limitleri kullanım kademesine göre ölçeklenir. Güncel limitler için fiyatlandırma sayfasına bakın.
Sorunları nereye bildirebilirim?
Herkese açık GitHub reposunda bir issue açın veya destek ekibine e-posta gönderin.
Z Image API’yi sevdiyseniz, bunları deneyin
Z Image API ile geliştirmeye başlayın.
- text_to_image