Kling 비디오 생성
AceDataCloud의 Kuaishou Kling API를 통해 AI 비디오를 생성합니다.
설정: 토큰 설정은 인증을 참조하세요.
빠른 시작
curl -X POST https://api.acedata.cloud/kling/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "a cat playing piano on a rooftop at sunset", "model": "kling-v3", "mode": "std", "duration": 5}'
비동기: 비동기 태스크 폴링을 참조하세요.
POST /kling/tasks에{"id": "..."}를 보내 폴링합니다.
모델
| 모델 | 품질 | 최적 용도 |
|---|---|---|
kling-v3 | 최신 | 최고 품질, 유연한 3~15초 지속 시간, 선택적 오디오 생성 |
kling-v3-omni | 최신 | 오디오 지원 Omni 모델, 유연한 3~15초 지속 시간 |
kling-v2-6 | 높음 | 선택적 오디오 지원 고품질 출력 (pro 모드) |
kling-v2-5-turbo | 높음 + 빠름 | 최고 속도/품질 균형 |
kling-v2-master | 높음 | 고품질 출력 |
kling-v2-1-master | 높음 | 개선된 v2 |
kling-v1-6 | 개선됨 | v1보다 우수한 품질 |
kling-v1 | 표준 | 기본 생성, 가장 저렴한 비용 |
kling-video-o1 | 프리미엄 | 최고 품질 (사고 모델) |
품질 모드
| 모드 | 속도 | 비용 | 용도 |
|---|---|---|---|
std (표준) | 느림 | 낮음 | 초안/미리보기 |
pro (전문가) | 빠름 | 높음 | 최종 출력 |
4k (네이티브 4K) | — | 프리미엄 | 네이티브 4K 출력 — kling-v3 및 kling-v3-omni만 지원; camera_control과 호환되지 않음 |
워크플로
1. 텍스트-비디오
POST /kling/videos
{
"action": "text2video",
"prompt": "a futuristic city with flying cars",
"model": "kling-v3",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
2. 이미지-비디오
정지 이미지를 애니메이션화합니다. 선택적으로 종료 프레임을 지정할 수 있습니다.
POST /kling/videos
{
"action": "image2video",
"prompt": "the scene slowly comes alive with movement",
"start_image_url": "https://example.com/scene.jpg",
"end_image_url": "https://example.com/end-scene.jpg",
"model": "kling-v3",
"mode": "pro"
}
3. 비디오 확장
기존 비디오를 추가 시간만큼 연장합니다.
POST /kling/videos
{
"action": "extend",
"video_id": "existing-video-id",
"prompt": "the camera pulls back to reveal the full landscape",
"model": "kling-v2-5-turbo"
}
4. 모션 컨트롤
이미지와 참조 비디오를 사용하여 정밀한 카메라/모션 컨트롤을 적용합니다.
POST /kling/motion
{
"image_url": "https://example.com/subject.jpg",
"video_url": "https://example.com/motion-reference.mp4"
}
5. 립싱크
소스 비디오와 오디오 트랙 또는 입력 텍스트를 사용하여 립싱크 비디오를 만듭니다.
POST /kling/lip-sync
{
"video_url": "https://example.com/source.mp4",
"mode": "audio2video",
"audio_url": "https://example.com/voiceover.mp3"
}
파라미터
| 파라미터 | 값 | 설명 |
|---|---|---|
action | "text2video", "image2video", "extend" | 생성 모드 |
model | 모델 표 참조 | 사용할 모델 |
mode | "std", "pro", "4k" | 품질 모드 (4k는 kling-v3/kling-v3-omni 전용, camera_control과 호환되지 않음) |
duration | 5, 10 (v3/v3-omni: 3~15) | 지속 시간 (초) |
generate_audio | true, false | 비디오와 함께 오디오 생성 (v3, v3-omni, v2-6 pro 전용) |
aspect_ratio | "16:9", "9:16", "1:1" | 비디오 종횡비 |
cfg_scale | 0~1 | 프롬프트 관련성 강도 |
negative_prompt | 문자열 | 비디오에서 피할 내용 |
camera_control | 객체 | 카메라 움직임 파라미터 |
element_list | 배열 | 요소 라이브러리에서 참조 대상 (각 항목에 element_id 포함). video_list와 결합 시 총 참조 이미지 + 대상 ≤ 7개 (참조 비디오 포함 시 ≤ 4개) |
video_list | 배열 | video_url을 통한 참조 비디오 (MP4/MOV, 3~10초, ≤200MB, 최대 1개 비디오). 각 항목에 video_url, refer_type ("feature" 또는 "base") 및 선택적 keep_original_sound 포함 |
callback_url | 문자열 | 비동기 콜백 URL |
mode (/kling/lip-sync) | "audio2video", "text2video" | 립싱크 모드 |
video_url (/kling/lip-sync) | URL | 립싱크를 위한 소스 비디오 URL |
video_id (/kling/lip-sync) | 문자열 | 립싱크를 위한 기존 Kling 비디오 ID |
audio_url (/kling/lip-sync) | URL | 오디오 소스 URL (audio2video용) |
audio_type (/kling/lip-sync) | "url", "file" | 오디오 입력 유형 (기본값 url) |
audio_file (/kling/lip-sync) | 문자열 | audio_type=file인 경우 오디오 파일 페이로드 |
text (/kling/lip-sync) | 문자열 | 음성을 합성할 입력 텍스트 (text2video용) |
voice_id (/kling/lip-sync) | 문자열 | text2video에서 사용되는 음성 프리셋 ID |
voice_language (/kling/lip-sync) | "zh", "en" | text2video용 TTS 언어 (기본값 zh) |
voice_speed (/kling/lip-sync) | 숫자 | TTS 말하기 속도 (기본값 1.0) |
주의사항
duration은 대부분 모델에서5또는10초를 지원하며,kling-v3및kling-v3-omni는 유연한3~15초를 지원합니다.mode=4k는kling-v3및kling-v3-omni에서만 사용 가능하며camera_control과 호환되지 않습니다.generate_audio는 동기화된 오디오 생성을 활성화합니다 (kling-v3,kling-v3-omni,kling-v2-6pro 모드에서 지원).end_image_url은image2video액션 전용이며, 마지막 프레임을 정의합니다.- 모션 컨트롤 (
/kling/motion)은 비디오 생성과 별개의 엔드포인트입니다. - 립싱크는 별개의 엔드포인트 (
/kling/lip-sync)이며mode가 필요합니다.audio2video의 경우audio_url을,text2video의 경우text+ 음성 필드를 사용합니다. pro모드는std모드보다 약 2배 비싸지만 더 빠르고 품질이 좋습니다.- 태스크 상태는
"succeed"를 사용합니다 ("succeeded" 아님) — 폴링 시 이 값을 확인하세요. negative_prompt는 원치 않는 요소를 피하는 데 도움이 됩니다 (예: "blurry, low quality, text").