Hermes Agent에서 Kling을 사용하세요.
Kuaishou의 Kling 3.0은 텍스트 또는 이미지로부터 최대 1080p의 영상을 네이티브 오디오, 멀티샷 장면, 3~15초 길이로 생성합니다. Hermes Agent는 채팅에서 설정한 것과 동일한 key와 base URL로 custom:runapi 프로바이더를 통해 RunAPI를 호출합니다.
Use RunAPI to generate a video with Kling 3.0 through Hermes Agent.
Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call POST https://runapi.ai/api/v1/kling/text_to_video
- Set model to "kling-3.0"
- The RUNAPI_API_KEY environment variable provides authorization
- Set duration_seconds to control length (3–15 seconds)
- Set aspect_ratio to "16:9" for landscape video
- Enable sound with enable_sound: true for native audio
- The response is async — poll the task status endpoint until the task completes, then retrieve the video URL
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "kling-3.0"
}
Hermes Agent에서 Kling을 세 단계로 사용하기
RunAPI 설정
RUNAPI_API_KEY 환경 변수를 설정하세요. Hermes Agent에서 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key와 base_url이 영상 생성에도 사용됩니다 — 추가 설정이 필요 없습니다.
export RUNAPI_API_KEY=runapi_xxx
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를 사용하세요.
POST /api/v1/kling/text_to_video
결과 가져오기
엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 영상 URL을 가져오세요. 생성에는 일반적으로 길이와 해상도에 따라 30~120초가 소요됩니다.
GET /api/v1/kling/text_to_video/tsk_abc123
Kling text_to_video API 파라미터
| 파라미터 | 유형 | 설명 |
|---|---|---|
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 |
세그먼트별로 별도의 프롬프트를 사용하여 멀티샷 장면 생성을 활성화합니다. |
Hermes Agent의 Kling이란?
Kuaishou의 Kling 3.0은 캐릭터 일관성과 뛰어난 모션 물리——천의 드레이프·유체 역학·사실적인 카메라 무브먼트——로 영화급 클립을 생성합니다. Hermes Agent의 custom:runapi provider를 통해 최대 1080p·네이티브 오디오의 텍스트→동영상·이미지→동영상이 가능하며, 단일 생성으로 3~15초(멀티샷 모드 최장 3분) 클립을 생성합니다.
Kling 활용 사례
긴 내러티브 콘텐츠
Kling의 멀티샷 모드로 최장 3분의 장면 길이 영상을 구성하며, 각 세그먼트에서 일관된 비주얼로 인서트 컷과 캐릭터 시퀀스를 연결합니다.
여행 및 자연 콘텐츠
사실적인 환경 렌더링으로 여행 Vlog B-롤과 자연 영상을 생성합니다. Kling은 물·안개·대기 조명 등 야외 장면에서 특히 뛰어납니다.
제품 데모 동영상
제품 이미지를 카메라 무브먼트와 자연스러운 조명 전환이 있는 짧은 동영상으로 애니메이션화합니다——이커머스 리스팅과 소셜 광고에 적합합니다.
Kling + Hermes Agent 자주 묻는 질문
Kling은 생성된 영상의 초당 요금을 부과합니다. 요금은 output_resolution과 enable_sound 활성화 여부에 따라 다릅니다. 사운드 없는 5초 720p 클립이 가장 저렴한 옵션이며, 사운드가 포함된 1080p는 초당 약 두 배의 비용이 듭니다. 정확한 요금은 RunAPI 가격 페이지를 확인하세요.
text_to_video는 텍스트 프롬프트만으로 클립을 생성합니다. image_to_video는 first_frame_image_url이 필요하며 해당 이미지로부터 애니메이션을 생성합니다. 두 엔드포인트 모두 비동기 task_id를 반환하며 동일한 길이와 해상도 옵션을 지원합니다.
네. RunAPI는 5초 또는 10초의 더 빠르고 저렴한 생성을 위한 kling-v2.5-turbo-text-to-video-pro와 kling-v2.5-turbo-image-to-video-pro도 제공합니다. 원하는 버전 슬러그로 model 파라미터를 설정하세요.
아니요. Hermes Agent에서 채팅이나 이미지 생성을 위해 custom:runapi 프로바이더를 이미 설정했다면, 동일한 base_url과 API key가 Kling 영상 엔드포인트에도 작동합니다. 요청 경로와 model 파라미터만 변경하면 됩니다.
아니요. RunAPI는 완료된 생성에 대해서만 요금을 청구합니다. 작업이 실패하거나 업스트림에서 타임아웃이 발생하면 예약된 크레딧이 계정 잔액으로 반환됩니다.
지금 Hermes Agent에서 Kling을 사용해보세요.
무료 RunAPI key를 발급받고, custom:runapi 프로바이더를 설정하여 Kling 3.0으로 영상 생성을 시작하세요.