Hermes Agent で Z Image を使う。
Z Image は Alibaba の高速画像生成モデルで、中国語と英語のバイリンガルテキスト描画を備えています。Hermes Agent はチャットで使用している RunAPI カスタムプロバイダーエンドポイントを通じて呼び出します。同じ base_url と API キーで追加プラグインや GPU レンタルは不要です。
Use the RunAPI text_to_image endpoint to generate an image with Z Image.
Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Send a POST request to https://runapi.ai/v1/text_to_image.
- Set model to "z-image".
- Write a descriptive prompt for the image you want to generate.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the image URL from the output.
- Use the custom:runapi provider configured in your Hermes Agent config.yaml.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "z-image"
}
3 ステップで Hermes Agent で Z Image を使う
RunAPI を設定する
RunAPI API キーを環境変数として設定します。すでに Hermes Agent で RunAPI をカスタムプロバイダーとして設定済みであれば、同じキーと base_url で画像生成が可能です。
export RUNAPI_API_KEY=runapi_xxx
Z Image を呼び出す
model を z-image に設定してテキストプロンプトを含めた POST リクエストを text_to_image エンドポイントに送ります。Z Image は正確なテキスト描画で中国語と英語の両方のプロンプトをサポートします。
text_to_image
結果を取得する
API は即座に task_id を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスの出力から生成された画像 URL を取得します。
task_id: tsk_abc123
Z Image API パラメーター
| パラメータ | 型 | 説明 |
|---|---|---|
model |
string |
必須。z-image を使用します。 |
prompt |
string |
テキスト説明。中国語と英語をサポート。 |
negative_prompt |
string |
省略可。画像に含めたくないもの。 |
size |
string |
省略可。出力サイズ(例:1024x1024)。 |
Hermes AgentのZ Imageとは?
Z Imageはサブ秒でフォトリアルな画像を生成し、プロンプト追従性が高く顔の細部が正確です。Apache 2.0オープンソース、RunAPI経由で1枚約$0.004と最速かつ最安の画像モデルです。Hermes Agentはチャットと同じcustom provider経由で呼び出します。
Z Imageの活用例
映像・アニメーションのストーリーボード制作
サブ秒でストーリーボードフレームを生成し、コンポジションやカメラアングルをリアルタイムのクリエイティブ議論に追いつくほどの速さで反復します。
EC商品ビジュアライゼーション
RunAPIで最低の1枚あたりコストでリアルな素材とライティングの商品リスト画像を生成し、大量カタログ生成に適しています。
教育用イラスト
中英バイリンガルのテキストラベル付きの教育図解やイラストを作成し、日中英圏の受講者向けの教科書・コース教材・研修コンテンツに使用します。
Z Image + Hermes Agent よくある質問
はい。Hermes Agent に RunAPI がカスタムプロバイダーとして設定されていれば、同じ API キーと base_url で Z Image リクエストを処理できます。model を z-image に設定して text_to_image エンドポイントに POST を送ります。
いいえ。チャットや他のモデルで使用している RUNAPI_API_KEY が Z Image でもそのまま使えます。すべての RunAPI モデルは 1 つのキーと 1 つのクレジット残高を共有します。
Z Image は非同期です。API は即座に task_id を返します。タスクステータスエンドポイントをポーリングするか、webhook コールバックを使って画像の準備ができたことを確認します。RunAPI SDK は自動的にポーリングを処理します。
Z Image はタスクごとの従量制課金です。現在の料金は RunAPI 料金ページで確認してください。月額サブスクリプションや最低支払い額はありません。
Hermes Agent 全般セットアップ
まだ設定していませんか?Hermes Agent の RunAPI セットアップガイドから始めてください。
Hermes Agent セットアップガイド →今すぐ Hermes Agent で Z Image を試す。
無料の RunAPI キーを取得し、カスタムプロバイダーを設定して、バイリンガルテキスト描画による画像生成を始めましょう。