Z Image Turbo API の統合方法：低コスト画像生成（$0.0036/枚）のプロダクション・ガイド

このガイドは意図的に客観的かつ実装優先で構成されています。以下のことを学びます：

• ZImage Turbo とはその主要な機能
• EvoLink の ZImage エンドポイントの仕組み（非同期タスク + Webhook ルール）
• コスト管理と運用ガードレールを備えた ZImage Turbo の統合方法
• ZImage がデフォルトとして適切な場合、およびそうでない場合

1. ZImage Turbo とは

• 高い視覚的忠実度を持つフォトリアルな画像生成
• 生成された画像内へのバイリンガル・テキスト描画（英語と中国語）
• 大規模なプロダクションに適した高速な推論速度
• 一貫性があり予測可能な出力のための指示追従性

ZImage Turbo の視覚的品質の例 A	ZImage Turbo の視覚的品質の例 B

2. ZImage の価格背景：公開されている表との比較

• EvoLink のモデルカタログでは、ZImage Turbo は 1 画像あたり $0.0036 からと記載されており、「市場」リファレンスとして $0.0050 が示されています。
• EvoLink は、ZImage Turbo に関する変更ログのエントリでも ~$0.0036/画像 という価格に言及しています。
• fal.ai の価格ページでは、広く使用されているホスト型画像モデルのいくつかが、1 画像あたり $0.03～$0.04 前後（モデルによる）でリストされています。
• fal.ai は、Z-Image Turbo の価格を $0.005/1メガピクセル としても記載しています（ZImage 自体の市場リファレンスとして有用です）。

コスト比較表（透明な前提条件）

前提条件：「1万画像」とは、それぞれ約 1MP の生成された出力を 10,000 個生成することを指します（例：1024×1024 ≈ 1MP）。お使いのプランと出力サイズにおける課金ルールを必ず確認してください。

3. EvoLink の ZImage Turbo API の仕組み（非同期設計）

1. POST /v1/images/generations に ZImage 生成リクエストを送信します
2. すぐにタスク IDを受け取ります
3. GET /v1/tasks/{task_id} を介してタスクの状態を照会するか、Webhook コールバックを使用します

4. ZImage Turbo クイックスタート（コピー＆ペースト）

4.1 ZImage 生成タスクの作成

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <YOUR_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "z-image-turbo",
  "prompt": "A clean product hero shot, studio lighting, soft shadow, minimal background, no watermark",
  "size": "1:1"
}
'

{
  "id": "task_abc123",
  "status": "pending",
  "model": "z-image-turbo",
  "progress": 0,
  "created": 1735100000,
  "task_info": {
    "can_cancel": true,
    "estimated_time": 10
  },
  "usage": {
    "credits_reserved": 1
  }
}

4.2 ZImage タスクの状態の照会

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <YOUR_TOKEN>'

5. ZImage Turbo パラメータ

• prompt: 必須、最大 2000 文字。
• size: アスペクト比（1:1、16:9 など）またはカスタム寸法（376x376 から 1536x1536）をサポート。
• seed: 再現性のための整数（1 - 2147483647）。
• callback_url: 非同期通知用の HTTPS URL。

6. ZImage Webhook：コールバック・ルール

• HTTPS のみ: 内部 IP は許可されません。
• リトライ: 最大 3 回（1秒、2秒、4秒の間隔）。
• 形式: コールバック・ボディはタスク照会 API のレスポンスと一致します。

7. ZImage のプロダクション・パターン

• パターン A：バリエーション選択：4～8 個の候補を安価に生成し、最適なものを選択します。
• パターン B：早期の永続化：出力をすぐに自身の S3/OSS に保存します（URL は 24 時間で期限切れになります）。
• パターン C：ワーカー・キュー：切り離されたワーカーを使用して、ステータスのポリングや Webhook を処理します。

8. ZImage プロンプト・テンプレート

テンプレート：バイリンガル・ポスターのドラフト

プロンプト: 明確なバイリンガル・タイポグラフィを備えた、すっきりとした小売ポスターのレイアウト。大きなタイトル：「Winter Sale」と「冬季大促」。サブタイトル：「Up to 50% off」と「最高立减50%」。モダンなグリッド・レイアウト、高コントラスト、サンセリフ体。

9. 意思決定マトリックス

10. FAQ

• アーキテクチャ: 6B モデル、S3-DiT アーキテクチャ、Turbo 用の 8 NFE。
• 保存期間: リンクの有効期限は 24 時間。
• 価格: EvoLink.ai では $0.0036 から開始。

結論