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.
- عدة إصدارات لمستويات مختلفة من السرعة / الجودة
- يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
- يعمل مع workflows موجهة لتطوير التطبيقات
- لا يتم احتساب رسوم على عمليات التوليد الفاشلة
التسعير
التفاصيل الفنية
| معرّف النموذج | z-image |
| المزوّد | Alibaba |
| الوسيط | image |
| نوع المهمة | asynchronous |
| وحدة الفوترة | call |
| API endpoint | /api/v1/z_image/text_to_image |
| ترخيص تجاري | نعم — مشمول عبر API |
| حالة الكتالوج | جاهز للتشغيل |
ثبّت skill Z Image لتطوير التطبيقات
حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.
# 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 إلى أول نتيجة في أربع خطوات
اختر النموذج
اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.
الإعداد
اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.
التنفيذ
استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.
الاستلام
استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.
ما هي Z Image API؟
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 عبر RunAPI
مصادقة واحدة لكل مزود
مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.
تسعير وفوترة موحّدان
تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.
Skill مع schemas
تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.
أسئلة شائعة
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.
أي نسخة ينبغي أن أبدأ بها؟
اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.
هل توجد خطة مجانية؟
تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.
هل تدعمون البث المباشر للنتائج؟
حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.
كيف يتم احتساب الرسوم عند الفشل؟
لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.
هل يتم تخزين المخرجات مؤقتًا؟
يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.
هل يمكنني الاستخدام تجاريًا؟
نعم — يشمل كل إصدار الاستخدام التجاري ما لم يقيّده ترخيص النموذج صراحةً، ويُشار إلى ذلك في صفحة الإصدار.
ماذا عن حدود المعدل؟
تتدرج حدود المعدل لكل مفتاح وفق فئة الاستخدام. راجع صفحة الأسعار للاطلاع على الحدود الحالية.
أين يمكنني الإبلاغ عن المشاكل؟
افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.
إذا أعجبتك Z Image API، فجرّب هذه الخيارات
ابدأ البناء باستخدام Z Image API.
- text_to_image