model: z-imageを指定して、POST https://api.goenhance.ai/api/v1/images/generationsから画像を生成します。Z-ImageはGoEnhanceの画像カタログの中で最も安価な1枚あたり一律0.004ドル（0.2トークン）で利用でき、ポーリングやコールバック用の非同期img_uuidが返されます。低コストでテキストから画像を生成するZ-Image API
テキストから画像への生成に特化したAPI
1枚あたり一律0.004ドルの料金設定
Z-Imageの生成は1回につき0.2トークン（0.004ドル相当）です。このモデルには解像度やボリュームによる段階的な料金設定がないため、コスト計算が容易です。
<code>z-image</code>リクエストスキーマでサポートされているフィールドのみを使用してください。
Z-Image APIのパラメータと機能
正確なモデルID
<code>model</code>を正確に<code>z-image</code>に設定してください。製品名はZ-Imageのままです。
必須プロンプト
生成する画像を記述する1〜2000文字の空ではない<code>prompt</code>を指定してください。
7つのアスペクト比
<code>1:1</code>、<code>2:3</code>、<code>3:2</code>、<code>4:3</code>、<code>3:4</code>、<code>16:9</code>、<code>9:16</code>から1つを選択してください。<code>ratio</code>を省略するとモデルのデフォルトが使用されます。
オプションのコールバック
<code>custom_callback_url</code>をパブリックなHTTPSエンドポイントに設定すると、処理状況、成功、失敗の更新を受け取ることができます。
テキストから画像への生成専用
このルートでは参照画像や編集入力は受け付けられません。参照ベースの編集が必要なワークフローには、他のGoEnhance画像モデルを使用してください。
スキーマ検証
サポートされていない比率は、トークンが消費される前のスキーマ検証で拒否されます。Z-Imageには<code>auto</code>や<code>21:9</code>の比率はありません。
単一の料金体系により、低価格な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 を登録して、処理中、成功、失敗の各ステータスを処理します。画像あたりのコストが予測可能で、リクエスト構造がコンパクトであることが重要な場合にZ-Imageを使用します。
低コストのテキストから画像への変換APIが適している場面
コンテンツ用イラスト
テキストプロンプトから記事、ガイド、編集ワークフロー用のビジュアルコンセプトを生成します。
製品コンセプト作成
製品、パッケージ、環境、キャンペーンテーマなどの初期ビジュアル案を制作前に作成します。
広告クリエイティブの検討
画像1枚あたりのコストを固定した状態で、クリエイティブレビュー用にプロンプト主導の多様なコンセプトを作成します。
ローカライズされたビジュアルパイプライン
サポートされているランドスケープ、ポートレート、スクエアの比率を選択しながら、地域ごとのテーマやフォーマットに合わせてプロンプトを調整します。
背景生成
参照編集を必要としない下流のデザインワークフロー向けに、シーンの背景や雰囲気のある素材を生成します。
大量のプロトタイピング
0.004ドルの固定レートを使用して、解像度やボリューム階層の計算なしでプロトタイプ生成コストを見積もります。
低コストのテキストから画像への変換APIを評価する開発者向けの統合詳細。