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 料金ページで確認してください。月額サブスクリプションや最低支払い額はありません。

HERMES + TOPAZ

Hermes Agent で Topaz を使う。

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

API キーを取得ドキュメントを読む

1 つの API キー · 画像アップスケールエンドポイント · 非同期タスクポーリング

Use RunAPI to upscale an image with Topaz.

Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call the RunAPI upscale_image endpoint at https://runapi.ai/api/v1/topaz/upscale_image.
- Set model to "topaz-upscale-image".
- Pass the image URL in image_url.
- Optionally set scale to 2, 4, or 8 (default is 2).
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the upscaled image URL from the result.

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
  }'

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

curl コマンドをコピーしてテスト topaz

仕組み

3 ステップで Hermes Agent で Topaz を使う

RunAPI を設定する

まだ Hermes Agent で RunAPI を設定していない場合は、Hermes Agent セットアップガイドに従います。base_url https://runapi.ai/v1、key_env RUNAPI_API_KEY、api_mode chat_completions でカスタムプロバイダー runapi を追加します。

export RUNAPI_API_KEY=runapi_xxx

Topaz upscale_image を呼び出す

model を topaz-upscale-image に設定し、ソースの image_url と省略可能なスケール係数（2、4、または 8）を指定して upscale_image エンドポイントに POST リクエストを送ります。同じ RunAPI キーで認証が処理されます。

POST /api/v1/topaz/upscale_image

結果をポーリングする

エンドポイントは status が pending の task_id を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスからアップスケールされた画像 URL を取得します。RunAPI SDK と CLI は自動的にポーリングを処理します。

GET /api/v1/topaz/upscale_image/tsk_abc123

パラメーター

Topaz upscale_image API パラメーター

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

Hermes AgentのTopazとは？

TopazはAI画像ワークフローに不可欠なポストプロダクションツールです——あらゆるモデルで生成した画像をプロ品質に引き上げます。RunAPIを通じて、Hermes Agentはあらゆる生成ステップの後にTopazを連結し、標準1K出力を印刷可能な8Kアセットに変換できます。デスクトップソフトウェアは不要です。