---
title: "RunAPI를 통해 Hermes Agent에서 Recraft 사용하기 — 업스케일 및 배경 제거"
url: "https://runapi.ai/ko/hermes-recraft.md"
canonical: "https://runapi.ai/ko/hermes-recraft"
locale: "ko"
model: "recraft"
---

# Hermes Agent에서 Recraft를 사용하세요.

Recraft는 아티팩트 없이 세밀한 디테일을 복원하는 선명한 신경망 이미지 업스케일링과 머리카락 가닥과 투명한 엣지를 보존하는 정밀한 배경 제거를 제공합니다. Hermes Agent는 채팅에 사용하는 동일한 RunAPI 커스텀 프로바이더를 통해 두 엔드포인트를 모두 호출합니다 — 소스 이미지 URL을 보내고, 업스케일 또는 배경 제거를 선택한 후 처리된 결과를 폴링하세요.

## API example

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

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "recraft-crisp-upscale"
}

```

## 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. **Recraft 업스케일 또는 배경 제거 호출** — model을 recraft-crisp-upscale로 설정하고 source_image_url을 제공하여 upscale_image 엔드포인트에 POST 요청을 보내세요. 배경 제거의 경우 대신 model recraft-remove-background로 remove_background 엔드포인트에 POST하세요. 두 엔드포인트 모두 source_image_url만 필요합니다.
3. **결과 폴링** — 두 엔드포인트 모두 status가 pending인 task_id를 반환합니다. status가 completed로 변경될 때까지 task status 엔드포인트를 폴링한 후 응답에서 처리된 이미지 URL을 가져오세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. 업스케일링에는 recraft-crisp-upscale, 배경 제거에는 recraft-remove-background. |
| `source_image_url` | `string` | 필수. 처리할 소스 이미지의 URL. |
| `callback_url` | `string` | 선택 사항. 비동기 완료 알림을 위한 웹훅 URL. |

## FAQ

### 하나의 Hermes Agent 워크플로우에서 Recraft 배경 제거와 업스케일링을 연결할 수 있나요?

네. 두 엔드포인트 모두 상태가 없으며 표준 이미지 URL을 받습니다. Hermes Agent에 먼저 원본 이미지로 remove_background를 호출한 다음 출력 URL을 upscale_image에 전달하도록 지시하세요. 동일한 custom:runapi 프로바이더가 두 호출을 모두 처리합니다.

### Recraft는 어떤 이미지 형식을 받고 출력하나요?

Recraft는 JPEG, PNG, WebP 입력을 받습니다. 배경 제거는 알파 투명도가 있는 PNG를 출력합니다. 업스케일 출력은 입력 형식과 일치합니다.

### Hermes Agent에서 업스케일과 배경 제거를 어떻게 전환하나요?

엔드포인트 경로와 model 필드를 변경하세요. 업스케일링에는 model recraft-crisp-upscale로 /api/v1/recraft/upscale_image를 사용하고, 배경 제거에는 model recraft-remove-background로 /api/v1/recraft/remove_background를 사용하세요. 두 엔드포인트 모두 동일한 API key와 custom:runapi 프로바이더를 사용합니다.

### Recraft 처리는 비동기인가요, 동기인가요?

두 Recraft 엔드포인트 모두 비동기입니다. API는 즉시 task_id를 반환합니다. 결과가 준비될 때까지 task status 엔드포인트를 폴링하세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

### RunAPI에서 Recraft 비용은 얼마인가요?

Recraft는 작업당 청구 방식을 사용합니다 — 업스케일링과 배경 제거는 처리된 이미지당 별도로 가격이 책정됩니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요. 구독이나 최소 지출이 필요 없습니다.


## Links

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