Z Image Turbo API
高性能なAI画像生成機能を統合できます。本ドキュメントでは、完全なAPIリファレンス、連携ガイド、コードサンプルを提供し、開発者がすばやくAI画像アプリケーションを構築できるようにします。
クイックスタート
生成タスクを送信し、ステータスをポーリングするだけの2ステップで、最初のAPI呼び出しを完了できます。
タスクを送信
POSTリクエストを generate エンドポイントに送信し、タスクIDを取得します。
ステータスを確認
タスクIDを使って進行状況を確認し、画像URLが返されるまでポーリングします。
認証
Authorization: Bearer {YOUR_API_KEY}注意: APIキーは安全に保管し、クライアントサイドのコードに公開しないでください。
https://zimageturbo.ai/api/generate
Create a new image generation task. This endpoint is asynchronous and returns a task_id plus initial status; call /api/status to retrieve the final images.
リクエストボディのパラメータ
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| prompt | string | 必須 | Text prompt for generation (max 1000 characters). |
| aspect_ratio | string | 必須 | Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16. |
{
"code": 200,
"message": "success",
"data": {
"task_id": "task_1234567890",
"status": "IN_PROGRESS"
}
}https://zimageturbo.ai/api/status
タスクの実行ステータスと結果を照会します。
クエリパラメータ
| パラメータ名 | 必須 | 説明 |
|---|---|---|
| task_id | 必須 | タスク送信時に返されるID。 |
{
"code": 200,
"message": "success",
"data": {
"status": "SUCCESS",
"task_id": "xxxxxxxx",
"request": {
"prompt": "xxx",
"size": "1024*1024",
"seed": "-1"
},
"response": [
"https://xxx.com/sample.jpeg"
],
"consumed_credits": 15,
"created_at": "2025-12-05 13:05:09",
"error_message": null
}
}
課金
1回あたりの料金
失敗したタスクには料金は発生しません。
エラー処理
- 401 Unauthorized無効なAPIキー
- 402 Payment Required残高不足
- 429 Too Many Requestsレート制限に達しました
Z Image Turboについて
Z Image Turboは、最新の拡散モデルをベースに最適化された生成エンジンです。推論速度を従来モデルの300%まで高めつつ、非常に高い忠実度を維持することに注力しています。リアルタイムのインタラクション、ゲームアセット生成、ECデザインなどのユースケースに適しています。
Z-Image-Turbo — 6B-parameter, ultra-fast text-to-image
Z-Image-Turbo is a 6B-parameter text-to-image model from Tongyi-MAI, engineered for production workloads where latency and throughput really matter. It uses only 8 sampling steps to render a full image, achieving sub-second latency on data-center GPUs and running comfortably on many 16 GB VRAM consumer cards.
Ultra-fast generation with production-ready quality
Where many diffusion models need dozens of steps, Z-Image-Turbo is aggressively optimised around an 8-step sampler. That keeps inference extremely fast while still delivering photorealistic images and reliable on-image text, making it a strong fit for interactive products, dashboards, and large-scale backends—not just offline batch jobs.
Why it looks so good?
- • Photorealistic output at speed — Generates high-fidelity, realistic images that work for product photos, hero banners, and UI visuals without multi-second waits.
- • Bilingual prompts and text — Understands prompts in English and Chinese, and can render multilingual text directly in the image—helpful for cross-market campaigns, posters, and screenshots.
- • Low-latency, low-step design — Only 8 function evaluations per image deliver extremely low latency, ideal for chatbots, configuration tools, design assistants, and any “click → image” experience.
- • Friendly VRAM footprint — Runs well in 16 GB VRAM environments, reducing hardware costs and making local or edge deployments more realistic.
- • Scales for bulk generation — Its efficiency makes large jobs—catalogues, continuous feed images, or auto-generated thumbnails—practical without blowing up compute budgets.
- • Reproducible generations — A controllable seed parameter lets you recreate a previous image or generate small, controlled variations for brand safety and experimentation.
How to use
- prompt – natural-language description of the scene, style, and any on-image text (English or Chinese).
- size (width / height) – choose the output resolution; supports square and rectangular images up to high resolutions (for example, 1536 × 1536).
- seed – set to -1 for random results, or use a fixed integer to make outputs reproducible.