OpenClaw で Topaz を使えますか？

はい。OpenClaw で RunAPI を OpenAI 互換プロバイダーとして設定し、Topaz の upscale_image エンドポイントを呼び出すよう指示します。チャットと画像生成で使用している RUNAPI_API_KEY がアップスケーリングリクエストにも使えます。

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

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

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

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

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

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

OPENCLAW + TOPAZ

OpenClaw で Topaz を使う。

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

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

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

Use RunAPI to upscale an image with Topaz.

Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- 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 ステップで OpenClaw で Topaz を使う

RunAPI を設定する

まだ OpenClaw で RunAPI を設定していない場合は、OpenClaw セットアップガイドに従います。RUNAPI_API_KEY 環境変数を設定し、baseUrl https://runapi.ai/v1 で RunAPI を OpenAI 互換プロバイダーとして追加します。

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。

OpenClaw上のTopazとは？

Topazは写真家が「写真忠実度のゴールドスタンダード」と呼ぶプログレードの画像フィニッシングツールです。画像を最大8倍の解像度にアップスケールし、元画像に忠実なクリアな結果を出力します。RunAPIではデスクトップアプリのサブスクリプションではなくAPIエンドポイントとして動作し、OpenClaw agentは自動化された画像パイプラインの1ステップとしてアップスケールを組み込めます。