Kuaishou · 비디오

Hermes Agent x Kling

Kling은 4K, AI 아바타, 멀티모달 오디오를 지원하는 Kuaishou의 플래그십 비디오 모델입니다. RunAPI를 통해 모든 Kling 변형이 통합 API 액세스와 과금 방식을 공유합니다.

18 variants 최저 $0.05 / 초 상업적 사용 지원
API 키 받기 Hermes Agent 문서 보기

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 kling-3.0를 사용하세요: 네이티브 4K, 최대 15초, 멀티샷 스토리보딩.

You have access to RunAPI task tools for Kling.

Available Kling models:
- kling-3.0: 네이티브 4K, 최대 15초, 멀티샷 스토리보딩
  endpoints: /api/v1/kling/text_to_video, /api/v1/kling/motion_control
  request fields: model, prompt, duration_seconds, aspect_ratio, output_resolution
- kling-ai-avatar-pro: 1080p 향상된 립싱크 + 얼굴 마이크로 표정
  endpoints: /api/v1/kling/ai_avatar
  request fields: model, source_image_url, source_audio_url, prompt
- kling-ai-avatar-standard: 720p 기본 립싱크
  endpoints: /api/v1/kling/ai_avatar
  request fields: model, source_image_url, source_audio_url, prompt
- kling-ai-avatar-v1-pro: 오디오 기반 립싱크가 포함된 V1 Pro 아바타 생성
  endpoints: /api/v1/kling/ai_avatar
  request fields: model, source_image_url, source_audio_url, prompt
- kling-o1: 이미지와 동영상 레퍼런스로 제어하는 전방위 영상 생성
  endpoints: /api/v1/kling/image_to_video, /api/v1/kling/text_to_video
  request fields: model, prompt, duration_seconds, aspect_ratio
- kling-v1-avatar-standard: 효율적인 토킹 헤드를 위한 V1 Standard 아바타 생성
  endpoints: /api/v1/kling/ai_avatar
  request fields: model, source_image_url, source_audio_url, prompt
- kling-v2.1-master-image-to-video: 더 강력한 렌더링의 프리미엄 V2.1 이미지-비디오
  endpoints: /api/v1/kling/image_to_video
  request fields: model, prompt, first_frame_image_url
- kling-v2.1-master-text-to-video: 더 강력한 렌더링의 프리미엄 V2.1 텍스트-비디오
  endpoints: /api/v1/kling/text_to_video
  request fields: model, prompt, duration_seconds, aspect_ratio
- kling-v2.1-pro: 선택적 마지막 프레임 제어를 갖춘 이미지-비디오
  endpoints: /api/v1/kling/image_to_video
  request fields: model, prompt, first_frame_image_url
- kling-v2.1-standard: 빠른 초안을 위한 저비용 V2.1 이미지 애니메이션
  endpoints: /api/v1/kling/image_to_video
  request fields: model, prompt, first_frame_image_url
- kling-v2.5-turbo-image-to-video-pro: 1080p 이미지 고정; 입력 이미지가 첫 프레임
  endpoints: /api/v1/kling/extend_video, /api/v1/kling/image_to_video
  request fields: model, prompt, first_frame_image_url
- kling-v2.5-turbo-text-to-video-pro: 1080p, 최대 10초, 30fps; 빠른 텍스트-비디오 초안
  endpoints: /api/v1/kling/text_to_video, /api/v1/kling/extend_video
  request fields: model, prompt, duration_seconds, aspect_ratio
- kling-v2.6: 텍스트·이미지 통합 영상 생성과 동기화된 네이티브 오디오
  endpoints: /api/v1/kling/text_to_video, /api/v1/kling/image_to_video, /api/v1/kling/motion_control
  request fields: model, prompt, duration_seconds, aspect_ratio
- kling-v3-omni: Kling v3 Omni의 네이티브 4K, 영상과 동기화된 사운드, 3~15초의 유연한 길이를 지원하는 올인원 영상 생성.
  endpoints: /api/v1/kling/image_to_video, /api/v1/kling/text_to_video
  request fields: model, prompt, duration_seconds, aspect_ratio, output_resolution
- kling-v3-omni-edit: 선택적 참조 이미지를 사용하여 원본 비디오 편집
  endpoints: /api/v1/kling/edit_video
  request fields: model, prompt, source_video_url, reference_image_urls, duration_seconds, output_resolution, aspect_ratio, enable_sound
- kling-v3-omni-reference: 참조 이미지와 원본 비디오 기반 영상 생성
  endpoints: /api/v1/kling/text_to_video, /api/v1/kling/edit_video
  request fields: model, prompt, duration_seconds, aspect_ratio, output_resolution, reference_image_urls
- kling-v3-turbo-image-to-video: 첫 프레임 이미지 한 장으로 만드는 3-15초 이미지-투-비디오 클립
  endpoints: /api/v1/kling/image_to_video
  request fields: model, prompt, first_frame_image_url
- kling-v3-turbo-text-to-video: 720p 또는 1080p의 3-15초 텍스트-투-비디오 클립
  endpoints: /api/v1/kling/text_to_video
  request fields: model, prompt, duration_seconds, aspect_ratio, output_resolution

Use the model ID and endpoint that match the user's request.
Example prompt: 나뭇잎이 떨어지는 가을 숲을 걷는 사람의 10초짜리 영상을 시네마틱 카메라 팬으로 만들어 주세요.
/api/v1/kling/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/kling/text_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/kling/text_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/kling/motion_control: Submit the task, poll for its status, then verify the completed output. POST /api/v1/kling/motion_control를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/kling/motion_control/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/kling/ai_avatar: Submit the task, poll for its status, then verify the completed output. POST /api/v1/kling/ai_avatar를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/kling/ai_avatar/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/kling/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/kling/image_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/kling/image_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/kling/extend_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/kling/extend_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/kling/extend_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/kling/edit_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/kling/edit_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/kling/edit_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
kling-3.0
/api/v1/kling/text_to_video /api/v1/kling/motion_control
$0.43 / 초 모델 상세
kling-ai-avatar-pro
/api/v1/kling/ai_avatar
$0.16 / 초 모델 상세
kling-ai-avatar-standard
/api/v1/kling/ai_avatar
$0.08 / 초 모델 상세
kling-ai-avatar-v1-pro
/api/v1/kling/ai_avatar
$0.16 / 초 모델 상세
kling-o1
/api/v1/kling/image_to_video /api/v1/kling/text_to_video
$0.08 / 초 모델 상세
kling-v1-avatar-standard
/api/v1/kling/ai_avatar
$0.08 / 초 모델 상세
kling-v2.1-master-image-to-video
/api/v1/kling/image_to_video
$0.61 / 초 모델 상세
kling-v2.1-master-text-to-video
/api/v1/kling/text_to_video
$0.61 / 초 모델 상세
kling-v2.1-pro
/api/v1/kling/image_to_video
$0.10 / 초 모델 상세
kling-v2.1-standard
/api/v1/kling/image_to_video
$0.05 / 초 모델 상세
kling-v2.5-turbo-image-to-video-pro
/api/v1/kling/extend_video /api/v1/kling/image_to_video
$0.16 / 초 모델 상세
kling-v2.5-turbo-text-to-video-pro
/api/v1/kling/text_to_video /api/v1/kling/extend_video
$0.16 / 초 모델 상세
kling-v2.6
/api/v1/kling/text_to_video /api/v1/kling/image_to_video /api/v1/kling/motion_control
$0.29 / 초 모델 상세
kling-v3-omni
/api/v1/kling/image_to_video /api/v1/kling/text_to_video
$0.91 / 초 모델 상세
kling-v3-omni-edit
/api/v1/kling/edit_video
$0.91 / 초 모델 상세
kling-v3-omni-reference
/api/v1/kling/text_to_video /api/v1/kling/edit_video
$0.91 / 초 모델 상세
kling-v3-turbo-image-to-video
/api/v1/kling/image_to_video
$0.18 / 초 모델 상세
kling-v3-turbo-text-to-video
/api/v1/kling/text_to_video
$0.18 / 초 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

Hermes Agent + Kling로 만들 수 있는 것

  • 더 긴 서사 콘텐츠

    설정 숏과 캐릭터 시퀀스를 이어 붙여, 클립 간에 일관된 비주얼을 유지하는 장면 길이의 영상을 만듭니다.

  • 여행과 자연 콘텐츠

    물, 안개, 분위기 있는 조명까지 사실적인 환경으로 여행 B롤과 자연 영상을 생성합니다.

  • 제품 데모 영상

    제품 이미지를 카메라 움직임과 자연스러운 조명 전환이 있는 짧은 영상으로 만들어 전자상거래 상품 페이지와 소셜 광고에 활용합니다.

Kling을(를) RunAPI + Hermes Agent로 사용하는 이유

  • 18개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

Hermes Agent + Kling 자주 묻는 질문

Hermes Agent에서 Kling 영상을 쓰려면 별도의 공급자가 필요한가요?

아니요. Hermes Agent에서 채팅이나 이미지용으로 RunAPI를 이미 설정했다면 같은 공급자와 API 키로 Kling 영상 엔드포인트도 사용할 수 있습니다.

Kling 생성이 실패하면 어떻게 되나요?

RunAPI는 완료된 생성에만 과금합니다. 작업이 실패하거나 시간이 초과되면 예약된 금액이 잔액으로 돌아옵니다.

Hermes Agent가 Kling 영상을 오디오 모델과 결합할 수 있나요?

네. Hermes Agent는 Kling으로 클립을 생성한 뒤 RunAPI를 통해 음성이나 음악 모델을 호출해 같은 워크플로에서 내레이션이나 배경 음악을 추가할 수 있습니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

Hermes Agent에서 Kling 사용 시작하기

API 키 받기 빠른 시작 읽기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기