요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
duration_seconds | 아니요 | 클립 길이. 초 단위로 요금이 붙습니다. ≥ 3 · ≤ 15 · 기본값: 5 |
generate_audio | 아니요 | 화면에 맞는 소리(목소리, 주변음, 효과음)를 더합니다. 기본값: false |
guidance_scale | 아니요 | 프롬프트를 얼마나 엄격히 따를지. ≥ 0 · ≤ 1 · 기본값: 0.5 |
image_url | 예 | 출발점이 되는 이미지. |
last_image_url | 아니요 | 선택 사항인 마지막 프레임. 원하는 장면에서 클립을 끝냅니다. |
multi_prompt | 아니요 | Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds. |
negative_prompt | 아니요 | 나오지 않았으면 하는 것. |
prompt | 예 | Describe what happens after the opening frame: the action, the camera and, with sound on, the sounds. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 720p · 1080p · 4k · 기본값: 720p |
shot_type | 아니요 | single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt. single · multi · customize · 기본값: single |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /초 | ≈ USD |
|---|---|---|
| generate_audio false · resolution 720p | 10.08 | US$0.10 |
| generate_audio false · resolution 1080p | 13.44 | US$0.13 |
| generate_audio true · resolution 720p | 15.12 | US$0.15 |
| generate_audio true · resolution 1080p | 20.16 | US$0.20 |
| generate_audio false · resolution 4K | 50.4 | US$0.50 |
| generate_audio true · resolution 4K | 50.4 | US$0.50 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 51크레딧/ 5초 영상(US$0.51)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Kling 3.0 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 kling/3.0/image-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "kling/3.0/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5,
"shot_type": "single"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Kling 3.0 API 질문
Kling 3.0 API 요금은 얼마인가요?
Kling 3.0 가격은 가장 저렴한 이미지로 영상 만들기 기준 51크레딧(US$0.51) / 5초 영상부터입니다. 옵션별 가격: false · 720p 10.08크레딧/초, false · 1080p 13.44크레딧/초, true · 720p 15.12크레딧/초, true · 1080p 20.16크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Kling 3.0의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 동영상 만들기: kling/3.0/text-to-video; 이미지로 영상 만들기: kling/3.0/image-to-video; 모션 컨트롤: kling/3.0/character-animation을(를) 넣으세요.
shot_type single은 하나의 연속 샷을 보장하나요?
그 자체만으로는 아닙니다. 저희 테스트에서 Kling 3.0은 single을 선택해도 가끔 두 번째 앵글로 컷했습니다. 테이크가 절대 끊기면 안 된다면 프롬프트에 "one continuous shot, no cuts" 같은 문장을 추가하세요. 같은 장면을 재시도했을 때 이 방법으로 해결됐습니다.
클립 생성에 시간이 얼마나 걸리나요?
Kling은 즉시 생성되지 않습니다. 클립당 몇 초가 아니라 몇 분 단위로 예상하시고, Motion Control과 더 높은 해상도는 더 오래 걸립니다. 작업이 진행되는 동안 플레이그라운드에서 진행 상황을 보여줍니다.
Kling 3.0 API의 제한은 무엇인가요?
영상 길이: 3–15 s; 해상도: 720p · 1080p · 4K; 프롬프트 길이(글자): 2,500; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Kling 3.0을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Kling 3.0을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Kling 모델
Kling O3는 더 유연한 형제 모델로, 한 컷에 참고 사진을 최대 7장 쓸 수 있고 멀티샷 자동 컷과 기존 영상 편집도 돼요. 첫·마지막 프레임이나 모션 컨트롤로 한 컷을 다듬어 만들 때는 Kling 3.0이에요.
- Kling 3.0 API4K 클립, 멀티숏 컷, 모션 컨트롤51크레딧부터 / 5초 영상
- Kling O3 APIKling 통합 모델: 생성·애니메이션·레퍼런스·편집을 최대 4K로51크레딧부터 / 5초 영상
- Kling 3.0 Turbo API더 빠른 Kling 3.0, 모든 클립에 사운드84크레딧부터 / 5초 영상
- Kling Avatar 2.0 API인물 사진이 내 오디오로 말하고 노래해요, 최대 5분7.68크레딧부터 /초
- Kling 2.6 API1080p 클립, 사운드와 모션 컨트롤은 선택52크레딧부터 / 5초 영상
- Kling 2.5 Turbo API1080p 클립, 매 테이크마다 사운드트랙42크레딧부터 / 5초 영상
- Kling 2.1 Master API프롬프트로 세밀하게 다루는 무음 1080p 클립162크레딧부터 / 5초 영상
- Kling 2.1 API프레임 한 장을 720p·1080p로 움직이고, 끝 프레임도 선택27크레딧부터 / 5초 영상

