---
title: "Hermes Agent에서 Flux Kontext 사용하기 via RunAPI — 이미지 API 가이드"
url: "https://runapi.ai/ko/hermes-flux-kontext.md"
canonical: "https://runapi.ai/ko/hermes-flux-kontext"
locale: "ko"
model: "flux-kontext"
---

# Hermes Agent에서 Flux Kontext 사용하기.

Black Forest Labs의 Flux Kontext는 캐릭터 일관성을 유지하며 텍스트 기반 이미지 편집 및 생성을 처리합니다. Hermes Agent는 채팅에 사용한 것과 동일한 key와 base URL로 custom:runapi provider를 통해 호출합니다.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "a matte-black water bottle on a beige stone surface, soft side light, studio photography"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "flux-kontext-pro"
}

```

## How it works

1. **RunAPI 설정** — RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 Hermes Agent에서 채팅용 custom:runapi provider로 RunAPI를 추가했다면, 동일한 key와 base_url이 이미지 생성에도 사용됩니다 — 추가 설정이 필요 없습니다.
2. **Flux Kontext 호출** — model을 flux-kontext-pro로 설정하여 text_to_image endpoint에 POST 요청을 보내세요. 원하는 이미지를 설명하는 텍스트 프롬프트를 포함하세요. 컨텍스트 편집을 위해 선택적으로 image_url을 전달할 수 있습니다.
3. **결과 가져오기** — endpoint는 task ID를 반환합니다. status가 completed로 변경될 때까지 task status endpoint를 폴링한 뒤, 응답에서 생성된 이미지 URL을 가져오세요.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. flux-kontext-pro 또는 flux-kontext-max. |
| `prompt` | `string` | 생성 또는 편집을 위한 텍스트 지시문. |
| `image_url` | `string` | 컨텍스트 편집을 위한 소스 이미지 URL. |
| `aspect_ratio` | `string` | 선택 사항. 출력 종횡비. |

## FAQ

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

네. Hermes Agent에서 RunAPI를 custom:runapi provider로 설정한 뒤, model을 flux-kontext-pro로 설정하여 text_to_image endpoint를 호출하세요. 채팅에 사용하는 RUNAPI_API_KEY가 이미지 생성에도 사용됩니다.

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

아니요. 동일한 RUNAPI_API_KEY가 LLM, 이미지, 비디오, 음악 등 모든 RunAPI 모델에 사용됩니다. 하나의 key, 하나의 결제 계정입니다.

### Flux Kontext는 비동기인가요, 동기인가요?

비동기입니다. API는 즉시 task ID를 반환합니다. task status endpoint를 폴링하거나 webhook callback을 사용해 완성된 이미지 URL을 받으세요.

### Flux Kontext 비용은 얼마인가요?

Flux Kontext Pro는 이미지당 2.5센트부터 시작합니다. Flux Kontext Max는 더 높은 품질을 위해 더 비쌉니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요 — 구독 없이 사용한 만큼 청구됩니다.


## Links

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