リファレンスv1.0.0 安定版

Z Image Turbo API

高性能なAI画像生成機能を統合できます。本ドキュメントでは、完全なAPIリファレンス、連携ガイド、コードサンプルを提供し、開発者がすばやくAI画像アプリケーションを構築できるようにします。

https://zimageturbo.ai
01

クイックスタート

生成タスクを送信し、ステータスをポーリングするだけの2ステップで、最初のAPI呼び出しを完了できます。

1

タスクを送信

POSTリクエストを generate エンドポイントに送信し、タスクIDを取得します。

2

ステータスを確認

タスクIDを使って進行状況を確認し、画像URLが返されるまでポーリングします。

02

認証

注意: APIキーは安全に保管し、クライアントサイドのコードに公開しないでください。

HTTPヘッダー
Authorization: Bearer {YOUR_API_KEY}
POST
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.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

リクエストボディのパラメータ

パラメータ名型必須説明
promptstring必須Text prompt for generation (max 1000 characters).
aspect_ratiostring必須Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.
レスポンス(JSON)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}
GET
https://zimageturbo.ai/api/status

タスクの実行ステータスと結果を照会します。

クエリパラメータ

パラメータ名必須説明
task_id必須タスク送信時に返されるID。
レスポンス例
{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

課金

1回あたりの料金

$0.02 / リクエスト

失敗したタスクには料金は発生しません。

エラー処理

  • 401 Unauthorized無効なAPIキー
  • 402 Payment Required残高不足
  • 429 Too Many Requestsレート制限に達しました
03

Z Image Turboについて

Z Image Turboは、最新の拡散モデルをベースに最適化された生成エンジンです。推論速度を従来モデルの300%まで高めつつ、非常に高い忠実度を維持することに注力しています。リアルタイムのインタラクション、ゲームアセット生成、ECデザインなどのユースケースに適しています。

Z-Image-Turbo — 60億パラメータの超高速テキスト→画像モデル

Z-Image-Turboは、Tongyi-MAIによる60億パラメータのテキスト・トゥ・イメージモデルで、レイテンシとスループットが重要となる本番ワークロード向けに設計されています。8ステップのサンプリングだけでフル画像を描画し、データセンターGPU上でサブセカンドレイテンシを達成し、多くの16 GB VRAMコンシューマカードでも快適に動作します。

本番品質を備えた超高速生成

多くの拡散モデルが数十ステップを必要とする一方で、Z-Image-Turboは8ステップサンプラーに最適化されています。そのため、極めて高速な推論を維持しつつ、フォトリアリスティックな画像や信頼性の高いオンイメージテキストを生成でき、インタラクティブなプロダクトやダッシュボード、大規模バックエンドだけでなく、バッチ処理以外の用途にも適しています。

なぜこれほどきれいに見えるのか？

  • 高速かつフォトリアル — 数秒待つことなく、商品写真、ヒーローバナー、UIビジュアルに使える高忠実度でリアルな画像を生成します。
  • バイリンガルプロンプトとテキスト — 英語と中国語のプロンプトを理解し、画像内に多言語テキストを直接レンダリングできます。クロスマーケットのキャンペーンやポスター、スクリーンショットに便利です。
  • 低レイテンシ・少ステップ設計 — 1画像あたり8回の関数評価のみで非常に低いレイテンシを実現し、チャットボット、コンフィグツール、デザインアシスタントなど「クリック → 画像」体験に理想的です。
  • VRAMに優しいフットプリント — 16 GB VRAM環境でも良好に動作し、ローカルまたはエッジでのデプロイを現実的なものにします。
  • 大量生成にスケール — 高効率な設計により、カタログ、継続フィード画像、自動生成サムネイルなどの大規模ジョブでも、コンピュート予算を抑えつつ実行できます。
  • 再現可能な生成 — 制御可能なseedパラメータにより、以前の画像を再生成したり、ブランドセーフティや実験のために小さなバリエーションを生成したりできます。

使い方

  • promptprompt – シーン、スタイル、画像内テキスト（英語または中国語）を含む自然言語での説明。
  • sizesize（幅 / 高さ） – 出力解像度を選択します。最大1536×1536など、正方形・長方形の高解像度画像をサポートします。
  • seedseed – ランダムな結果が必要な場合は -1 を指定し、同じ出力を再現したい場合は固定の整数値を使用します。
Z-Image-EditPrompts

© 2025 Z Image Turbo AI Inc. 無断転載禁止。