텍스트·이미지·참조 주체로 3~15초 영상을 만드는 Kling 3.0 기반 생성 API
영상 작업은 접수한 뒤 상태를 조회하고, 완료되면 MP4 파일을 내려받는 흐름입니다. 취소 API는 제공하지 않으며, 실패하거나 처리 시간이 초과되면 예약된 포인트가 자동으로 전액 환불됩니다.
job_id<job_id>.mp4/rest/kling/jobstext 모드는 CL_AUTH_KEY와 JSON 본문을, image·reference 모드는 첨부 파일이 있으므로 multipart/form-data를 사용합니다.duration × 초당 포인트가 예약 차감됩니다. 완료 시 확정되고, 실패·시간 초과 시 전액 환불됩니다.job_id, waiting 상태, 모델 정보와 예약 포인트를 반환합니다.text | image | reference, 기본 textstd | pro, 기본 std16:9 | 9:16 | 1:1, 기본 16:9APICK_VIDEO_OPTION_NOT_SUPPORTED로 거절됩니다. std 등급은 720P·1080P-SR·1440P-SR(기본 720P), pro 등급은 1080P·1440P-SR(기본 1080P)true(정책 검수에서 오디오가 거부되면 작업이 실패하고 환불됩니다)_·-, 8~128자seed는 Kling에서 지원하지 않으며 전달하면 APICK_VIDEO_OPTION_NOT_SUPPORTED로 거절됩니다.
이미지는 PNG·JPEG, 300~8,192px, 종횡비 0.4~2.5, 10MB 이하만 허용합니다(다른 모델보다 낮은 한도입니다). 참조 영상은 MP4·MOV·WebM, 50MB 이하만 허용합니다.
curl -X POST "https://apick.app/rest/kling/jobs" \
-H "CL_AUTH_KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"도심 야경 속을 걷는 인물의 뒷모습, 네온 반사","duration":5,"tier":"std"}'curl -X POST "https://apick.app/rest/kling/jobs" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "mode=image" \
-F "image=@first_frame.png" \
-F "prompt=바람에 머리카락이 흩날리는 장면" \
-F "resolution=720P"{
"data": {
"job_id": "9c8b7a6f5e4d3c2b1a0f9e8d7c6b5a4f",
"status": "waiting",
"model": "kling",
"mode": "text",
"tier": "std",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": null,
"audio": true,
"point_per_second": 410,
"charged_point": 2050
},
"api": { "success": true, "cost": 2050 }
}/rest/kling/jobs/{job_id}job_id를 URL에 넣고 CL_AUTH_KEY를 전송합니다. 완료 전에는 5초 간격 조회를 권장합니다.waiting, processing, completed, failed 중 하나를 반환합니다.result_available과 result_expires_at으로 다운로드 가능 여부와 만료 시각을 확인합니다.curl -sS "https://apick.app/rest/kling/jobs/$JOB_ID" \
-H "CL_AUTH_KEY: $API_KEY"{
"data": {
"job_id": "9c8b7a6f5e4d3c2b1a0f9e8d7c6b5a4f",
"status": "completed",
"model": "kling",
"mode": "text",
"tier": "std",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": null,
"audio": true,
"point_per_second": 410,
"charged_point": 2050,
"result_available": true,
"result_expires_at": "2026-09-20T12:00:00.000Z"
},
"api": { "success": true, "cost": 0 }
}{
"data": {
"job_id": "9c8b7a6f5e4d3c2b1a0f9e8d7c6b5a4f",
"status": "failed",
"result_available": false,
"result_expires_at": null,
"error": { "code": "APICK_VIDEO_GENERATION_FAILED", "message": "영상 생성에 실패했습니다. 포인트는 환불되었습니다." }
},
"api": { "success": true, "cost": 0 }
}/rest/kling/jobs/{job_id}/resultresult_available이 true일 때 호출합니다. Range 헤더로 구간 다운로드를 지원합니다(HTTP 206).video/mp4 파일을 반환합니다. 완료 후 7일 동안 반복 다운로드할 수 있습니다.<job_id>.mp4 파일이며 Content-Disposition으로 파일명을 안내합니다.curl -sS "https://apick.app/rest/kling/jobs/$JOB_ID/result" \
-H "CL_AUTH_KEY: $API_KEY" \
-o "$JOB_ID.mp4"접수 시 duration × 초당 포인트가 예약 차감됩니다. 완료되면 그대로 확정되고, 실패하거나 처리 시간이 초과되면 예약된 포인트가 전액 환불됩니다. 접수 후에는 취소할 수 없습니다.
APICK_VIDEO_AUTH_FAILEDAPICK_VIDEO_PAYMENT_REQUIREDAPICK_VIDEO_POINTS_INSUFFICIENTAPICK_VIDEO_INVALID_REQUESTAPICK_VIDEO_PROMPT_REQUIREDAPICK_VIDEO_MODE_NOT_SUPPORTEDAPICK_VIDEO_DURATION_INVALIDAPICK_VIDEO_SOURCE_REQUIREDAPICK_VIDEO_SOURCE_INVALIDAPICK_VIDEO_TOO_MANY_ACTIVE_JOBSAPICK_VIDEO_CONTENT_REJECTEDAPICK_VIDEO_RATE_LIMITEDAPICK_VIDEO_TEMPORARILY_UNAVAILABLEAPICK_VIDEO_TIMEOUTAPICK_VIDEO_GENERATION_FAILEDAPICK_VIDEO_JOB_NOT_FOUNDAPICK_VIDEO_JOB_CONFLICTAPICK_VIDEO_RESULT_EXPIREDMCP 도구로도 동일하게 사용할 수 있습니다. kling_jobs_create로 작업을 접수하고 kling_jobs_status로 상태를 조회합니다. 영상 파일은 MCP 응답 크기 제한 때문에 도구로 직접 전달하지 않으며, 상태 조회 응답의 result_url로 REST 다운로드 경로를 안내합니다. 자세한 내용은 MCP 연동 가이드와 /mcp/ai를 확인하세요.
REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.