低コストでテキストから画像を生成するZ-Image API

model: z-imageを指定して、POST https://api.goenhance.ai/api/v1/images/generationsから画像を生成します。Z-ImageはGoEnhanceの画像カタログの中で最も安価な1枚あたり一律0.004ドル(0.2トークン)で利用でき、ポーリングやコールバック用の非同期img_uuidが返されます。
APIキーを作成する
Z-Imageによるテキストから画像への生成を表現した映画のようなクリエイティブスタジオのシーン

テキストから画像への生成に特化したAPI

プロンプト優先生成

必須のpromptフィールド(1〜2000文字)を使用して画像を記述します。現在の統合エンドポイントではmodel: z-imageが必要です。
詳細なプロンプトが完成した画像に変わる様子を描いた想像力豊かな単一シーンのビジュアル

1枚あたり一律0.004ドルの料金設定

Z-Imageの生成は1回につき0.2トークン(0.004ドル相当)です。このモデルには解像度やボリュームによる段階的な料金設定がないため、コスト計算が容易です。
効率的な大規模画像生成を表現した洗練された単一シーンの制作セットアップ
<code>z-image</code>リクエストスキーマでサポートされているフィールドのみを使用してください。

Z-Image APIのパラメータと機能

正確なモデルID

modelを正確にz-imageに設定してください。製品名はZ-Imageのままです。

必須プロンプト

生成する画像を記述する1〜2000文字の空ではないpromptを指定してください。

7つのアスペクト比

1:1、2:3、3:2、4:3、3:4、16:9、9:16から1つを選択してください。ratioを省略するとモデルのデフォルトが使用されます。

オプションのコールバック

custom_callback_urlをパブリックなHTTPSエンドポイントに設定すると、処理状況、成功、失敗の更新を受け取ることができます。

テキストから画像への生成専用

このルートでは参照画像や編集入力は受け付けられません。参照ベースの編集が必要なワークフローには、他のGoEnhance画像モデルを使用してください。

スキーマ検証

サポートされていない比率は、トークンが消費される前のスキーマ検証で拒否されます。Z-Imageにはautoや21:9の比率はありません。
単一の料金体系により、低価格なAI画像生成APIの予算計算が容易になります。

シンプルで一律なZ-Imageの料金設定

1枚あたり0.004ドル

生成が成功するたびに、1枚あたり正確に0.004ドルが課金されます。

1枚あたり0.2トークン

同等の料金は0.2トークンです。GoEnhanceのトークンは500トークンで10ドル、つまり1トークンあたり0.02ドルで販売されています。

解像度やボリュームによる段階的料金なし

Z-Imageは1枚あたりの一律料金です。リクエストに解像度パラメータは公開されておらず、公開されている料金はボリュームによって変動しません。

3ステップでZ-Imageを統合

1

1. プロンプトを送信する

認証済みPOSTリクエストを https://api.goenhance.ai/api/v1/images/generations に送信し、{"model":"z-image","prompt":"...","ratio":"16:9"} を含めます。
2

2. img_uuidを保存する

送信に成功すると data.img_uuid が返されます。画像が生成されるのを同期的に待つのではなく、アプリケーションのレコードと一緒に保存してください。
3

3. ポーリングまたはコールバックを受け取る

GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., をポーリングするか、custom_callback_url を登録して、処理中、成功、失敗の各ステータスを処理します。
APIキーを作成する
画像あたりのコストが予測可能で、リクエスト構造がコンパクトであることが重要な場合にZ-Imageを使用します。

低コストのテキストから画像への変換APIが適している場面

コンテンツ用イラスト

テキストプロンプトから記事、ガイド、編集ワークフロー用のビジュアルコンセプトを生成します。

製品コンセプト作成

製品、パッケージ、環境、キャンペーンテーマなどの初期ビジュアル案を制作前に作成します。

広告クリエイティブの検討

画像1枚あたりのコストを固定した状態で、クリエイティブレビュー用にプロンプト主導の多様なコンセプトを作成します。

ローカライズされたビジュアルパイプライン

サポートされているランドスケープ、ポートレート、スクエアの比率を選択しながら、地域ごとのテーマやフォーマットに合わせてプロンプトを調整します。

背景生成

参照編集を必要としない下流のデザインワークフロー向けに、シーンの背景や雰囲気のある素材を生成します。

大量のプロトタイピング

0.004ドルの固定レートを使用して、解像度やボリューム階層の計算なしでプロトタイプ生成コストを見積もります。
低コストのテキストから画像への変換APIを評価する開発者向けの統合詳細。

Z-Image APIに関するよくある質問

Z-Image APIにはどのエンドポイントを使用すべきですか?

POST https://api.goenhance.ai/api/v1/images/generations を使用し、model を z-image に設定してください。レガシーな POST /api/v1/z-image ルートも存在しますが、現在ドキュメント化されている統合パスは統合画像エンドポイントです。

なぜ一部の検索でTurboという名称が使われるのですか?

Alibaba/Tongyiは上位モデルをZ-Image Turboと呼称しています。GoEnhanceのカタログおよびAPIドキュメントでは、製品名はZ-Imageであり、正確なモデルIDは z-image です。

Z-Imageの生成コストはいくらですか?

一律料金は画像1枚あたり0.004ドルで、0.2トークンに相当します。このモデルには解像度やボリュームによる階層設定はありません。

Z-Imageはどの比率をサポートしていますか?

1:1、2:3、3:2、4:3、3:4、16:9、9:16 の7種類です。このルートは auto や 21:9 を受け付けません。

参照画像を送信したり、既存の画像を編集したりできますか?

いいえ。このルートのZ-Imageはテキストから画像への変換専用であり、参照画像、画像から画像への入力、編集リクエストは受け付けません。参照ベースの編集には別のGoEnhanceモデルを選択してください。

1回の呼び出しで解像度を指定したり、複数の画像を要求したりできますか?

いいえ。Z-Imageのスキーマには解像度フィールドや n (バッチカウント)パラメータはありません。複数の出力が必要な場合は、生成リクエストを個別に送信してください。

非同期のZ-Imageジョブはどのように完了しますか?

生成レスポンスが img_uuid を返します。/api/v1/jobs/detail?img_uuid=... をポーリングするか、custom_callback_url を指定してステータスの変更を受け取ります。

GoEnhanceはAlibabaと提携していますか?

いいえ。Z-ImageはAlibabaのTongyi/Qwen組織が提供するものです。GoEnhanceオープンAPIは独立したサードパーティプラットフォームであり、Alibabaとは提携しておらず、またAlibabaの推奨も受けていません。

Z-Image APIで開発を始める