---
title: "Hermes Agent에서 RunAPI로 Kling 사용하기 — 영상 API 가이드"
url: "https://runapi.ai/ko/hermes-kling.md"
canonical: "https://runapi.ai/ko/hermes-kling"
locale: "ko"
model: "kling"
---

# Hermes Agent에서 Kling을 사용하세요.

Kuaishou의 Kling 3.0은 텍스트 또는 이미지로부터 최대 1080p의 영상을 네이티브 오디오, 멀티샷 장면, 3~15초 길이로 생성합니다. Hermes Agent는 채팅에서 설정한 것과 동일한 key와 base URL로 custom:runapi 프로바이더를 통해 RunAPI를 호출합니다.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/kling/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "A drone shot pulling back from a mountain lake at sunrise, mist rising off the water, cinematic lighting",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "enable_sound": true,
    "output_resolution": "1080p"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "kling-3.0"
}

```

## How it works

1. **RunAPI 설정** — RUNAPI_API_KEY 환경 변수를 설정하세요. Hermes Agent에서 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key와 base_url이 영상 생성에도 사용됩니다 — 추가 설정이 필요 없습니다.
2. **Kling text_to_video 호출** — model을 kling-3.0으로 설정하여 /api/v1/kling/text_to_video에 POST 요청을 보내세요. 프롬프트, duration_seconds (3~15), aspect_ratio를 포함하고 선택적으로 enable_sound로 네이티브 오디오를 활성화하세요. 이미지 기반 생성의 경우, first_frame_image_url을 사용하여 /api/v1/kling/image_to_video를 사용하세요.
3. **결과 가져오기** — 엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 영상 URL을 가져오세요. 생성에는 일반적으로 길이와 해상도에 따라 30~120초가 소요됩니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. kling-3.0은 최신 버전입니다. |
| `prompt` | `string` | 영상 설명. multi_shots가 활성화되지 않은 경우 필수. |
| `duration_seconds` | `integer` | 영상 길이. Kling 3.0은 3~15초를 지원합니다. 이전 버전은 5초 또는 10초. |
| `aspect_ratio` | `string` | 출력 화면 비율: 16:9, 9:16, 또는 1:1. |
| `output_resolution` | `string` | 해상도: 720p, 1080p, 또는 4k. 해상도가 높을수록 초당 비용이 더 많이 듭니다. |
| `enable_sound` | `boolean` | 영상과 함께 네이티브 오디오를 생성합니다. 초당 비용이 증가합니다. |
| `negative_prompt` | `string` | 생성에서 제외할 요소. |
| `first_frame_image_url` | `string` | 시작 프레임으로 사용할 이미지 URL (싱글샷 모드). |
| `cfg_scale` | `number` | 가이던스 스케일 (0~1). 값이 높을수록 프롬프트를 더 엄격히 따릅니다. |
| `multi_shots` | `boolean` | 세그먼트별로 별도의 프롬프트를 사용하여 멀티샷 장면 생성을 활성화합니다. |

## FAQ

### RunAPI에서 Kling 초당 청구 방식은 어떻게 작동하나요?

Kling은 생성된 영상의 초당 요금을 부과합니다. 요금은 output_resolution과 enable_sound 활성화 여부에 따라 다릅니다. 사운드 없는 5초 720p 클립이 가장 저렴한 옵션이며, 사운드가 포함된 1080p는 초당 약 두 배의 비용이 듭니다. 정확한 요금은 RunAPI 가격 페이지를 확인하세요.

### text_to_video와 image_to_video의 차이점은 무엇인가요?

text_to_video는 텍스트 프롬프트만으로 클립을 생성합니다. image_to_video는 first_frame_image_url이 필요하며 해당 이미지로부터 애니메이션을 생성합니다. 두 엔드포인트 모두 비동기 task_id를 반환하며 동일한 길이와 해상도 옵션을 지원합니다.

### Kling 3.0 외에 다른 버전을 사용할 수 있나요?

네. RunAPI는 5초 또는 10초의 더 빠르고 저렴한 생성을 위한 kling-v2.5-turbo-text-to-video-pro와 kling-v2.5-turbo-image-to-video-pro도 제공합니다. 원하는 버전 슬러그로 model 파라미터를 설정하세요.

### Hermes Agent에 Kling 영상을 위한 별도의 프로바이더가 필요한가요?

아니요. Hermes Agent에서 채팅이나 이미지 생성을 위해 custom:runapi 프로바이더를 이미 설정했다면, 동일한 base_url과 API key가 Kling 영상 엔드포인트에도 작동합니다. 요청 경로와 model 파라미터만 변경하면 됩니다.

### Kling 생성이 실패하면 요금이 청구되나요?

아니요. RunAPI는 완료된 생성에 대해서만 요금을 청구합니다. 작업이 실패하거나 업스트림에서 타임아웃이 발생하면 예약된 크레딧이 계정 잔액으로 반환됩니다.


## Links

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