OpenClaw で Z Image を使う。
Z Image は Alibaba の高速画像生成モデルで、中国語と英語のバイリンガルテキスト描画を備えています。OpenClaw エージェントはチャットで使用している RunAPI エンドポイントと API キーを通じて呼び出します。追加スキルやプロバイダーアカウントは不要です。
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.
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 ステップで OpenClaw で Z Image を使う
RunAPI を設定する
RunAPI API キーを環境変数として設定します。OpenClaw でチャット用に RunAPI を設定済みであれば、同じキーで画像生成が可能です。
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)。 |
OpenClaw上のZ Imageとは?
Z Imageは速度最適化型の画像モデルで、Apache 2.0オープンソース、中英テキスト双方向レンダリング対応、RunAPI経由で1枚約$0.004と最安クラスの選択肢です。OpenClaw agentはチャットと同じAPIキーで呼び出します。
Z Imageの活用例
コンセプト探索と高速プロトタイピング
1セントあたり数十枚のペースで視覚コンセプトを生成し、最終出力に高価なモデルを使う前に方向性を探るのに最適です。
バイリンガルマーケティングキャンペーン
1枚の画像に中国語と英語のテキストを正確にレンダリングし、越境ECや多言語SNS向けのマーケティングビジュアルを制作します。
ファッション・商品写真モックアップ
正確な素材質感とライティングでリアルな商品写真モックアップを生成し、リアルタイムでコンポジションを反復できる速さで制作します。
Z Image + OpenClaw よくある質問
はい。OpenClaw にプロバイダーとして RunAPI が設定されていれば、同じ API キーとエンドポイントで 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 料金ページで確認してください。月額サブスクリプションや最低支払い額はありません。
今すぐ OpenClaw で Z Image を試す。
無料の RunAPI キーを取得し、プロンプトを OpenClaw に貼り付けて、バイリンガルテキスト描画による画像生成を始めましょう。