---
title: "Hermes Agent で Z Image を RunAPI 経由で使う — 画像 API ガイド"
url: "https://runapi.ai/ja/hermes-z-image.md"
canonical: "https://runapi.ai/ja/hermes-z-image"
locale: "ja"
model: "z-image"
---

# Hermes Agent で Z Image を使う。

Z Image は Alibaba の高速画像生成モデルで、中国語と英語のバイリンガルテキスト描画を備えています。Hermes Agent はチャットで使用している RunAPI カスタムプロバイダーエンドポイントを通じて呼び出します。同じ base_url と API キーで追加プラグインや GPU レンタルは不要です。

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "z-image"
}

```

## How it works

1. **RunAPI を設定する** — RunAPI API キーを環境変数として設定します。すでに Hermes Agent で RunAPI をカスタムプロバイダーとして設定済みであれば、同じキーと base_url で画像生成が可能です。
2. **Z Image を呼び出す** — model を z-image に設定してテキストプロンプトを含めた POST リクエストを text_to_image エンドポイントに送ります。Z Image は正確なテキスト描画で中国語と英語の両方のプロンプトをサポートします。
3. **結果を取得する** — API は即座に task_id を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスの出力から生成された画像 URL を取得します。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必須。z-image を使用します。 |
| `prompt` | `string` | テキスト説明。中国語と英語をサポート。 |
| `negative_prompt` | `string` | 省略可。画像に含めたくないもの。 |
| `size` | `string` | 省略可。出力サイズ（例：1024x1024）。 |

## FAQ

### Hermes Agent で Z Image を使えますか？

はい。Hermes Agent に RunAPI がカスタムプロバイダーとして設定されていれば、同じ API キーと base_url で Z Image リクエストを処理できます。model を z-image に設定して text_to_image エンドポイントに POST を送ります。

### Z Image に別の API キーが必要ですか？

いいえ。チャットや他のモデルで使用している RUNAPI_API_KEY が Z Image でもそのまま使えます。すべての RunAPI モデルは 1 つのキーと 1 つのクレジット残高を共有します。

### Z Image は非同期ですか、同期ですか？

Z Image は非同期です。API は即座に task_id を返します。タスクステータスエンドポイントをポーリングするか、webhook コールバックを使って画像の準備ができたことを確認します。RunAPI SDK は自動的にポーリングを処理します。

### Z Image のコストは？

Z Image はタスクごとの従量制課金です。現在の料金は RunAPI 料金ページで確認してください。月額サブスクリプションや最低支払い額はありません。


## Links

- [Hermes Agent セットアップガイド →](https://runapi.ai/ja/hermes-agent)
- [Z Image モデル →](https://runapi.ai/ja/models/z-image)
- [Model catalog](https://runapi.ai/ja/models)
- [API docs](https://runapi.ai/ja/docs)