Kling V4 Flash

2026-11-07 확인한 APIMaster kling-v4-flash 사양입니다. 채널 317은 텍스트, 첫 이미지, 참조, 편집, 연장을 지원합니다. 720p, 24fps, 3–20초만 지원하며 Kling V4와 별도 모델입니다.

Kling V4 Flash

엔드포인트와 인증

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

매개변수

JSON 및 Authorization: Bearer YOUR_API_KEY 사용, model=kling-v4-flash. prompt는 단일 첫 이미지에서만 생략 가능. duration/seconds는 JSON 정수 3–20, 기본 5. null은 생략, 0은 거부하며 둘 다 지정하면 유효하고 같아야 합니다. 편집에서 생략하면 입력 영상 스트림 길이를 올림합니다. resolution은 720p만. aspect_ratio 또는 별칭 size는 16:9, 9:16, 1:1, 21:9, 참조에서만 auto도 허용. 기본은 텍스트 16:9, 참조 auto, 편집은 입력 비율. 이미지 생성과 연장은 비어 있지 않은 aspect_ratio/size를 거부합니다. audio는 true, watermark는 false만 허용.

매개변수	JSON 형식	필수 여부	기본값	용도 및 제한
model	string	필수	kling-v4-flash	다섯 작업 모두 kling-v4-flash를 사용합니다. kling-v4는 별도 모델입니다.
prompt	string	모드별	—	장면, 움직임 또는 편집 내용을 설명합니다. 단일 첫 프레임 모드에서만 생략할 수 있습니다. 각 배열 순서에 따라 이미지와 비디오를 각각 @Image1, @Video1부터 참조하며 편집 원본은 @Video1입니다.
duration	integer / null	선택	5	3–20의 JSON 정수 초이며 일반 기본값은 5입니다. 편집에서 두 시간 필드를 모두 생략하면 입력 비디오 스트림 시간을 올림합니다. 연장에서는 새 구간 길이입니다. null은 생략, 0·정수가 아닌 수치·숫자 문자열은 오류입니다.
seconds	integer / null	선택	—	duration의 별칭이며 같은 제한을 적용합니다. 하나만 사용하는 것을 권장합니다. 둘 다 있으면 각각 유효하고 값이 같아야 하며, 다르면 400입니다.
resolution	string	선택	720p	720p만 지원합니다. 출력 짧은 변이 항상 720px라는 뜻은 아닙니다. 1080p나 mode를 통한 화질 선택은 지원하지 않습니다.
aspect_ratio	string	선택	모드별	텍스트·참조·편집은 16:9, 9:16, 1:1, 21:9를 지원하며 auto는 참조 전용입니다. 기본값은 텍스트 16:9, 참조 auto, 편집은 원본 비율입니다. 이미지 생성·연장은 비어 있지 않은 값을 거부하며 빈 문자열은 생략 처리합니다.
size	string	선택	—	aspect_ratio의 호환 별칭으로 해상도나 픽셀 크기가 아닙니다. 두 값을 함께 보내면 일치해야 합니다. 첫 프레임 생성·연장에서는 둘 다 생략합니다.
image_urls	string[]	모드별	—	공개 이미지 URL 배열입니다. auto는 첫 프레임 한 장만 허용합니다. 이미지 전용 참조는 reference를 명시합니다. 참조·편집은 역할 참조 이미지와 합쳐 최대 10장입니다. 다른 첫 프레임 표현과 혼용하지 않으며 연장은 이미지를 받지 않습니다.
first_frame_image	string	모드별	—	유일한 첫 프레임의 공개 URL입니다. image_urls 한 항목 또는 first_frame 역할과 셋 중 하나만 사용합니다. 너비·높이 각각 300px 이상, 비율 2:5–5:2가 필요하며 필요하면 먼저 자릅니다.
image_with_roles	{url, role}[]	모드별	—	각 객체에 공개 URL인 url과 role이 필요합니다. first_frame은 유일한 첫 프레임, reference_image는 참조·편집용입니다. 마지막·중간·키프레임은 불가합니다. 참조 이미지 합계≤10, 이미지·참조 비디오 합계≤15입니다.
video_url	string	모드별	—	명시적 edit/extend의 단일 원본 URL이며 video_urls와 상호 배타적입니다. 편집은 MP4/MOV, 스트림 길이 3–20초, 두 변 각각 700–4553px입니다. 연장은 마지막 프레임부터 새 구간만 반환합니다. 작업·대화 ID를 넣지 않습니다.
video_urls	string[]	모드별	—	참조 MP4/MOV 최대 5개, 각 스트림 최소 3초, 두 변 각각 700–4553px, 총 20초 이하입니다. edit/extend를 명시하면 한 항목으로 video_url을 대체할 수 있습니다. 초과 시 자르지 않고 거부하며 기본적으로 참조 모드를 선택합니다.
omni_reference_task_type	string	선택	auto	auto는 텍스트/첫 프레임/참조를 판별합니다. reference는 참조 소재가 필요하며 edit/extend는 비디오 한 개가 필요합니다. 모드 없는 video_url이나 auto에서 일반 이미지 두 장은 유효하지 않습니다.
audio_setting	string	선택	auto	비디오를 포함한 참조 모드 전용입니다. auto는 소리를 새로 생성하고 origin은 첫 참조 비디오 소리를 보존합니다. 첫 영상에 오디오 트랙이 없으면 결과에도 없습니다. 편집·연장·텍스트·이미지 전용 참조에서는 생략합니다.
audio	boolean	선택	true	호환 boolean으로 생략 또는 true만 허용하며 false는 거부합니다. 원음 보존에는 지원되는 audio_setting을 사용합니다. 별도 참조 오디오는 불가합니다.
watermark	boolean	선택	false	호환 boolean으로 생략 또는 false만 허용하며 true는 거부합니다. 원본 워터마크 제거 기능이 아닙니다.

인증 정보 없는 공개 HTTP(S) 직접 URL만 사용합니다. base64·로컬 경로·작업 ID는 불가합니다. 이미지 형식·바이트 상한은 별도 공표되지 않았습니다. 100MiB는 탐사하는 참조·편집 비디오별 읽기 상한이며 공통 업로드 제한이 아닙니다.

모드와 자료

작업	선택 및 필수 소재	기본값 및 제외 사항
텍스트 생성	소재 없이 prompt 필수, 타입 생략 또는 auto.	5초·16:9, audio_setting 없음.
첫 프레임 생성	세 표현 중 하나로 한 장만 제공, prompt 선택.	5초·이미지 비율, aspect_ratio/size·마지막 프레임 불가.
참조 생성	reference + 이미지, reference_image 또는 video_urls, prompt 필수.	5초·auto, 이미지≤10·비디오≤5·총≤15, 오디오 설정은 비디오가 있어야 사용.
비디오 편집	edit + 비디오 한 개, prompt 필수, 참조 이미지 최대 10장.	시간은 원본을 올림, 비율은 원본, 프레임 역할/audio_setting 불가.
비디오 연장	extend + 비디오 한 개, prompt 필수.	새로운 5초, 이미지·비율 변경/audio_setting 불가. 편집·참조의 최소 크기·시간 검사는 적용하지 않음.

omni_reference_task_type은 auto, reference, edit, extend. image_urls 한 장, first_frame_image 또는 first_frame 역할 한 장이 시작 이미지입니다. 여러 이미지는 reference 또는 reference_image 역할이 필요하며 auto의 image_urls 두 장은 거부. video_urls는 기본 참조, 명시한 edit/extend는 해당 모드. video_url은 edit/extend가 필수이며 video_urls와 배타적입니다. 편집/연장은 영상 한 개 필요. 편집은 참조 이미지를 추가할 수 있으나 연장은 이미지/audio_setting을 거부하고 새 구간만 반환합니다. 원본 영상 공개 URL을 사용하며 작업 ID나 대화 ID는 입력하지 않습니다.

인증 정보 없는 공개 HTTP(S) 직접 URL만 사용합니다. 이미지 최대 10개, 이미지/영상 참조 합계 15개. 이미지 최소 300×300, 비율 2:5–5:2. 참조는 MP4/MOV 최대 5개, 각각 최소 3초, 합계 최대 20초. 편집은 3–20초 영상 하나로 너비와 높이 각각 700–4553픽셀. 게이트웨이는 영상당 최대 100 MiB를 읽고 컨테이너/음성이 아닌 영상 트랙을 측정합니다. 이 최소 길이·크기 검사는 연장 입력에 적용하지 않습니다. 이미지 크기는 공급자도 검증합니다. audio_setting=origin은 첫 참조 영상 음성을 유지하며 트랙이 없으면 무음, auto는 음성 생성. 영상이 있는 참조에서만 사용합니다. 편집은 음성을 새로 생성합니다. 음성 URL, 마지막/중간 이미지, 키프레임, negative_prompt, mode, seed, 다중 장면 및 인물/음성 목록은 미지원.

출력 픽셀 및 프레임 속도

비율 / 작업	문서에 명시된 출력 픽셀	프레임 속도
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
첫 프레임 생성	이미지 비율을 따르며 약 0.92MP, 예: 2:5에서 604×1516.	24 fps

출력 크기는 입력 조건과 다릅니다. 21:9 높이 628px는 참조·편집 입력의 최소 700px를 충족하지 않으므로 맞는 원본을 준비해야 합니다. 연장에는 이 최소 크기를 적용하지 않습니다. 결과는 약 한 프레임 길 수 있습니다.

실행하지 않는 예제

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

요금 계산

공식 명목 기본가는 출력 초당 $0.094(720P), 영상이 있는 경우 청구 초당 $0.0628(720P-input). 텍스트, 이미지, 영상 없는 참조, 연장은 출력/새 구간만 계산합니다. 영상 참조 및 편집은 출력 + max(입력, 출력). 모든 입력 영상 트랙 길이를 먼저 합산한 후 초 단위 올림합니다. 입력 3.04초, 출력 3초면 3+max(4,3)=7 청구 초. 약 한 프레임이 더 있어도 요청한 정수 출력 길이를 사용합니다. 패키지 할인과 계정 배율은 별도이며 현재 카드와 최종 소비 로그를 따릅니다. 확인된 생성 실패는 예약 환불. 조회 중지는 취소가 아니며 불명 네트워크 시간 초과에 새 생성으로 재시도하지 마세요.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

조회·오류·안전한 재시도

첫 접수는 HTTP 200, 공개 task_id, queued. GET /v1/videos/{task_id}로 queued/in_progress/completed/failed를 조회하고 임시 unknown도 처리합니다. url과 metadata.url은 Bearer 필요. GET /v1/videos/{task_id}/content로도 다운로드합니다. 생성 실패는 error.code=generation_failed와 정제 메시지, 매개변수 오류는 HTTP 400. Idempotency-Key는 공백 없는 표시 가능한 ASCII 8–128자. 같은 계정/키/요청은 HTTP 202로 이중 생성/예약 없이 반환, 변경은 409. GET /v1/video-submissions/by-key는 원래 키의 영수증만 읽습니다. accepted+task_ready=true면 task_id 조회, pending/submitting 또는 미준비면 대기. acceptance_unknown은 키를 보관해 지원에 연락하고 자동 재전송하지 않습니다. 404는 미접수 증거가 아닙니다. 최소 30일 보관. 공급자 검색이 아닌 게이트웨이 보호입니다. 최종 요금은 other.task_id로 소비 로그에서 확인하며 작업 조회는 최종 청구서를 보장하지 않습니다. /v1/videos/quote 미지원. 예제는 실행하지 않습니다. URL을 교체하고 새 작업마다 새 키를 쓰세요.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI