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

# Hermes Agent에서 Topaz 사용하기.

Topaz Labs의 Topaz는 아티팩트 없이 세부 사항을 복원하는 신경망을 사용하여 이미지를 최대 8배 해상도로 업스케일합니다. Hermes Agent는 채팅과 이미지 생성에 사용하는 동일한 RunAPI custom provider를 통해 호출합니다 — 이미지 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라는 custom 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

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

네. Hermes Agent에서 base_url을 https://runapi.ai/v1로, key_env를 RUNAPI_API_KEY로 설정하여 RunAPI를 custom provider로 설정한 뒤, Topaz upscale_image endpoint를 호출하도록 agent에 지시하세요. 채팅에 사용하는 동일한 custom:runapi provider가 업스케일링 요청도 처리합니다.

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

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

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

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

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

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


## Links

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