---
title: "Hermes Agent で Grok Imagine を RunAPI 経由で使う — 画像・動画 API ガイド"
url: "https://runapi.ai/ja/hermes-grok-imagine.md"
canonical: "https://runapi.ai/ja/hermes-grok-imagine"
locale: "ja"
model: "grok-imagine"
---

# Hermes Agent で Grok Imagine を使う。

Grok Imagine は xAI の画像・動画生成スイートです。テキストから画像、画像から画像、テキストから動画、画像から動画に対応しています。Hermes Agent はチャットで使用している RunAPI カスタムプロバイダーと API キーを通じて呼び出します。追加プラグインは不要です。

## 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": "grok-imagine-text-to-image",
    "prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "grok-imagine-text-to-image"
}

```

## How it works

1. **RunAPI を設定する** — シェルプロファイルに RUNAPI_API_KEY 環境変数を設定します。Hermes Agent でチャット用に custom:runapi プロバイダーが設定済みであれば、同じキーで Grok Imagine が使えます。追加セットアップは不要です。
2. **Grok Imagine を呼び出す** — model を grok-imagine-text-to-image に設定してプロンプトを含めた POST リクエストを text_to_image エンドポイントに送ります。動画の場合は grok-imagine-text-to-video で text_to_video を使います。
3. **結果を取得する** — API は即座に task_id を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスから出力の画像または動画 URL を取得します。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必須。例：grok-imagine-text-to-image、grok-imagine-image-to-video。 |
| `prompt` | `string` | 生成したい出力のテキスト説明。 |
| `image_url` | `string` | 画像から画像または画像から動画用のソース画像 URL。 |
| `aspect_ratio` | `string` | 省略可。出力アスペクト比（例：16:9、1:1）。 |

## FAQ

### Hermes Agent で Grok Imagine を使えますか？

はい。Hermes Agent に RunAPI がカスタムプロバイダー（custom:runapi）として設定済みであれば、同じ API キーと base_url で Grok Imagine が使えます。model を grok-imagine-text-to-image に設定して text_to_image エンドポイントを呼び出します。

### Grok Imagine に別の API キーが必要ですか？

いいえ。チャットや他のモデルで使用している RUNAPI_API_KEY が Grok Imagine でもそのまま使えます。1 つのキーで RunAPI カタログの 113 以上のモデルすべてを利用できます。

### Grok Imagine は非同期ですか、同期ですか？

非同期です。API は即座に task_id を返します。タスクが完了するまでタスクステータスエンドポイントをポーリングします。RunAPI SDK と CLI は自動的にポーリングを処理します。

### Grok Imagine のコストは？

Grok Imagine は RunAPI 経由でタスクごとの課金です。現在の料金は RunAPI 料金ページで確認してください。生成に失敗した場合は課金されません。


## Links

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