---
title: "Hermes Agent で Topaz を RunAPI 経由で使う — AI 画像アップスケーリング API ガイド"
url: "https://runapi.ai/ja/hermes-topaz.md"
canonical: "https://runapi.ai/ja/hermes-topaz"
locale: "ja"
model: "topaz"
---

# Hermes Agent で Topaz を使う。

Topaz（Topaz Labs 製）はアーティファクトなしに詳細を回復するニューラルネットワークを使用して画像を最大 8 倍の解像度にアップスケールします。Hermes Agent はチャットと画像生成で使用している RunAPI カスタムプロバイダーを通じて呼び出します。画像 URL を送り、スケール係数を選択して、拡大された結果をポーリングするだけです。

## API example

```bash
curl -X POST https://runapi.ai/api/v1/topaz/upscale_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "topaz-upscale-image",
    "image_url": "https://example.com/photo.jpg",
    "scale": 4
  }'

```

### Response

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

```

## How it works

1. **RunAPI を設定する** — まだ Hermes Agent で RunAPI を設定していない場合は、Hermes Agent セットアップガイドに従います。base_url https://runapi.ai/v1、key_env RUNAPI_API_KEY、api_mode chat_completions でカスタムプロバイダー runapi を追加します。
2. **Topaz upscale_image を呼び出す** — model を topaz-upscale-image に設定し、ソースの image_url と省略可能なスケール係数（2、4、または 8）を指定して upscale_image エンドポイントに POST リクエストを送ります。同じ RunAPI キーで認証が処理されます。
3. **結果をポーリングする** — エンドポイントは status が pending の task_id を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスからアップスケールされた画像 URL を取得します。RunAPI SDK と CLI は自動的にポーリングを処理します。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必須。topaz-upscale-image または topaz-upscale-video。 |
| `image_url` | `string` | アップスケールする画像の URL。 |
| `scale` | `integer` | 省略可。アップスケール係数：2、4、または 8。デフォルトは 2。 |
| `callback_url` | `string` | 省略可。非同期完了通知用の webhook URL。 |

## FAQ

### Hermes Agent で Topaz を使えますか？

はい。Hermes Agent で RunAPI をカスタムプロバイダーとして設定し、base_url https://runapi.ai/v1 と key_env RUNAPI_API_KEY を指定して、Topaz の upscale_image エンドポイントを呼び出すよう指示します。チャットで使用している同じ custom:runapi プロバイダーでアップスケーリングリクエストも処理できます。

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

いいえ。チャット、画像生成、その他のモデルに使用している RUNAPI_API_KEY が Topaz アップスケーリングでもそのまま使えます。すべての RunAPI モデルは 1 つの API キーと 1 つのクレジット残高を共有します。

### Topaz アップスケーリングは非同期ですか、同期ですか？

Topaz アップスケーリングは非同期です。エンドポイントは即座に task_id を返します。Hermes Agent はアップスケールされた画像が準備できるまでタスクステータスエンドポイントをポーリングします。RunAPI SDK と CLI は自動的にポーリングを処理します。

### Topaz アップスケーリングのコストは？

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


## Links

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