---
title: "OpenClaw에서 Topaz 사용하기 via RunAPI — AI 이미지 업스케일링 API 가이드"
url: "https://runapi.ai/ko/openclaw-topaz.md"
canonical: "https://runapi.ai/ko/openclaw-topaz"
locale: "ko"
model: "topaz"
---

# OpenClaw에서 Topaz 사용하기.

Topaz Labs의 Topaz는 아티팩트 없이 세부 사항을 복원하는 신경망을 사용하여 이미지를 최대 8배 해상도로 업스케일합니다. OpenClaw agent는 채팅과 이미지 생성에 사용하는 동일한 RunAPI key로 호출합니다 — 이미지 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 설정** — 아직 OpenClaw에서 RunAPI를 설정하지 않았다면 OpenClaw 설정 가이드를 따르세요. RUNAPI_API_KEY 환경 변수를 설정하고, baseUrl을 https://runapi.ai/v1로 설정하여 RunAPI를 OpenAI 호환 provider로 추가하세요.
2. **Topaz upscale_image 호출** — model을 topaz-upscale-image로, 소스 image_url과 선택적으로 2, 4, 또는 8의 scale 인수를 설정하여 upscale_image endpoint에 POST 요청을 보내세요. 동일한 RunAPI key가 인증을 처리합니다.
3. **결과 폴링** — endpoint는 status pending으로 task_id를 반환합니다. status가 completed로 변경될 때까지 task status endpoint를 폴링한 뒤, 응답에서 업스케일된 이미지 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

### OpenClaw에서 Topaz를 사용할 수 있나요?

네. OpenClaw에서 RunAPI를 OpenAI 호환 provider로 설정한 뒤, Topaz upscale_image endpoint를 호출하도록 agent에 지시하세요. 채팅과 이미지 생성에 사용하는 동일한 RUNAPI_API_KEY가 업스케일링 요청도 처리합니다.

### Topaz에 별도의 API key가 필요한가요?

아니요. 채팅, 이미지 생성 및 다른 모델에 사용하는 동일한 RUNAPI_API_KEY가 Topaz 업스케일링에도 사용됩니다. 모든 RunAPI 모델은 하나의 API key와 하나의 크레딧 잔액을 공유합니다.

### Topaz 업스케일링은 비동기인가요, 동기인가요?

Topaz 업스케일링은 비동기입니다. endpoint는 즉시 task_id를 반환합니다. OpenClaw agent는 업스케일된 이미지가 준비될 때까지 task status endpoint를 폴링합니다. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

### Topaz 업스케일링 비용은 얼마인가요?

Topaz는 RunAPI를 통해 task당 사용한 만큼 청구됩니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요. 월 구독이나 최소 지출이 없습니다.


## Links

- [OpenClaw 설정 가이드 →](https://runapi.ai/ko/openclaw)
- [Topaz 모델 →](https://runapi.ai/ko/models/topaz)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)