Kling V3.0 4K는 Novita AI에서 두 개의 전용 API 엔드포인트로 제공됩니다. 텍스트-투-비디오용 kling-v3.0-4k-t2v와 이미지-투-비디오용 kling-v3.0-4k-i2v입니다. 둘 다 네이티브 3840×2160 출력을 생성하며, 3~15초 길이를 지원하고, 모든 Novita 비디오 API에서 사용되는 동일한 비동기 작업 패턴을 따릅니다. 이미 파이프라인에 Kling V3.0 Standard 또는 Pro를 사용 중이라면 4K 계층으로 전환하는 것은 모델 ID 한 줄만 변경하면 됩니다.
이 가이드는 4K 전용 엔드포인트만 다룹니다. 네이티브 오디오 생성, 멀티샷 구성 또는 초당 Standard/Pro 가격에 대해서는 Novita AI의 Kling 3.0 출시 개요를 참조하세요.
Kling V3.0 4K vs Standard 및 Pro: 언제 사용할까?
4K 계층은 출력 해상도가 제약 조건일 때 적합합니다. 즉, 인쇄 품질 자산, 대형 스크린 디스플레이, 또는 합성이나 크롭을 위해 고해상도 소스 프레임이 필요한 다운스트림 워크플로우에 유용합니다.
모든 사용 사례에서 Standard나 Pro를 대체하지는 않습니다. 반복 작업과 프롬프트 테스트는 낮은 해상도에서 더 저렴하며, 4K 생성은 작업당 시간이 더 오래 걸립니다. 실용적인 워크플로우는 Standard로 반복 작업한 후, 최종 승인된 프롬프트에 대해 kling-v3.0-4k-t2v 또는 kling-v3.0-4k-i2v로 전환하는 것입니다.
kling-v3.0-4k-t2v를 사용하는 경우:
- 장면이 프롬프트로 완전히 설명 가능할 때
- 참조 이미지가 없거나 중요하지 않을 때
kling-v3.0-4k-i2v를 사용하는 경우:
- 특정 첫 프레임이 생성된 클립을 고정해야 할 때
- 소스 이미지에서 일관된 피사체 모양이 필요할 때
1단계: Novita AI API 키 받기
novita.ai에서 가입하고 대시보드에서 API 키를 생성하세요. 새 계정에는 무료 크레딧이 포함됩니다. 키를 환경 변수로 저장하고 소스 파일에 하드코딩하지 마세요.
export NOVITA_API_KEY="your_api_key_here"
2단계: 모델 ID 및 엔드포인트
| 모드 | 모델 ID | 엔드포인트 |
|---|---|---|
| 텍스트-투-비디오 | kling-v3.0-4k-t2v |
POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v |
| 이미지-투-비디오 | kling-v3.0-4k-i2v |
POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v |
| 결과 조회 | — | GET https://api.novita.ai/v3/async/task-result?task_id=<id> |
두 엔드포인트 모두 JSON을 허용하고, Authorization 헤더에 Bearer 토큰이 필요하며, 즉시 task_id를 반환합니다. 실제 비디오는 작업 결과 엔드포인트에서 별도로 조회합니다.
공식 API 참고 자료:
3단계: 첫 번째 요청 보내기
curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v \
-H "Authorization: Bearer $NOVITA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A lone lighthouse on a rocky coast at golden hour, cinematic wide shot, waves crashing",
"negative_prompt": "blurry, low quality, distorted",
"duration": 5,
"aspect_ratio": "16:9",
"cfg_scale": 0.5
}'
응답은 task_id를 반환합니다:
{
"task_id": "t2v-kling-4k-abc123"
}
해당 ID를 저장하세요. 결과를 조회하는 데 필요합니다.
4단계: 비디오 결과 폴링
curl "https://api.novita.ai/v3/async/task-result?task_id=t2v-kling-4k-abc123" \
-H "Authorization: Bearer $NOVITA_API_KEY"
완료된 작업은 status: "TASK_STATUS_SUCCEED"와 videos 배열을 포함하는 task 객체를 반환합니다:
{
"task": {
"task_id": "t2v-kling-4k-abc123",
"status": "TASK_STATUS_SUCCEED"
},
"videos": [
{
"video_url": "https://...",
"video_url_ttl": 3600,
"video_type": "mp4"
}
]
}
일반적인 상태 값: TASK_STATUS_QUEUED, TASK_STATUS_PROCESSING, TASK_STATUS_SUCCEED, TASK_STATUS_FAILED. 이 값을 기준으로 폴링 루프를 구성하세요. 4K 생성은 1080P보다 시간이 더 오래 걸리므로 고정된 대기 시간을 가정하지 마세요.
5단계: 이미지-투-비디오 요청
이미지-투-비디오 엔드포인트는 prompt 외에 image_url이 필요합니다. 이미지가 첫 프레임을 정의하고, 모델이 그로부터 움직임을 생성합니다.
curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v \
-H "Authorization: Bearer $NOVITA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "The lighthouse beam sweeps across the fog, slow dramatic movement",
"negative_prompt": "fast cuts, shake, low quality",
"image_url": "https://your-storage.example.com/lighthouse-frame.jpg",
"duration": 5,
"aspect_ratio": "16:9",
"cfg_scale": 0.5
}'
이미지 요구 사항 (현재 제한 사항은 Novita API 참고 자료에서 확인):
- 형식:
.jpg,.jpeg,.png - 최대 파일 크기: 10 MB
- 최소 크기: 300×300 픽셀
결과 조회 단계는 T2V와 동일합니다. 반환된 task_id로 /v3/async/task-result를 폴링하세요.
Python 예제
T2V — 텍스트를 4K 비디오로
import os
import time
import requests
API_KEY = os.environ["NOVITA_API_KEY"]
BASE_URL = "https://api.novita.ai"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
def submit_t2v(prompt: str, duration: int = 5, aspect_ratio: str = "16:9") -> str:
payload = {
"prompt": prompt,
"negative_prompt": "blurry, low quality",
"duration": duration,
"aspect_ratio": aspect_ratio,
"cfg_scale": 0.5,
}
resp = requests.post(
f"{BASE_URL}/v3/async/kling-v3.0-4k-t2v",
headers=HEADERS,
json=payload,
timeout=30,
)
resp.raise_for_status()
return resp.json()["task_id"]
def poll_result(task_id: str, interval: int = 10, max_wait: int = 600) -> dict:
deadline = time.time() + max_wait
while time.time() < deadline:
resp = requests.get(
f"{BASE_URL}/v3/async/task-result",
headers=HEADERS,
params={"task_id": task_id},
timeout=30,
)
resp.raise_for_status()
data = resp.json()
status = data.get("task", {}).get("status", "")
if status == "TASK_STATUS_SUCCEED":
return data
if status == "TASK_STATUS_FAILED":
raise RuntimeError(f"Task failed: {data}")
time.sleep(interval)
raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")
if __name__ == "__main__":
task_id = submit_t2v(
prompt="A lone lighthouse on a rocky coast at golden hour, cinematic wide shot",
duration=5,
aspect_ratio="16:9",
)
print(f"Task submitted: {task_id}")
result = poll_result(task_id)
video_url = result["videos"][0]["video_url"]
print(f"Video ready: {video_url}")
I2V — 이미지를 4K 비디오로
def submit_i2v(
prompt: str,
image_url: str,
duration: int = 5,
aspect_ratio: str = "16:9",
) -> str:
payload = {
"prompt": prompt,
"negative_prompt": "blurry, low quality",
"image_url": image_url,
"duration": duration,
"aspect_ratio": aspect_ratio,
"cfg_scale": 0.5,
}
resp = requests.post(
f"{BASE_URL}/v3/async/kling-v3.0-4k-i2v",
headers=HEADERS,
json=payload,
timeout=30,
)
resp.raise_for_status()
return resp.json()["task_id"]
동일한 poll_result 함수를 사용하여 생성된 비디오를 조회합니다.
주요 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
prompt |
string | 예 | 장면 설명. 주제, 움직임, 카메라 각도, 조명을 구체적으로 명시하세요. |
negative_prompt |
string | 아니요 | 억제할 것: 흐림, 흔들림, 아티팩트, 원치 않는 스타일. |
duration |
integer | 아니요 | 비디오 길이(초). 범위: 3~15. 기본값은 문서 확인. |
aspect_ratio |
string | 아니요 | "16:9", "9:16", "1:1". 기본값: "16:9". |
cfg_scale |
float | 아니요 | 프롬프트 준수 강도. 0.5는 안전한 시작 값입니다. |
image_url |
string | I2V 전용 | 첫 프레임 이미지. 공개적으로 접근 가능한 URL이어야 합니다. |
해상도 및 길이 대비 비용
4K 생성은 초당 비용이 Standard나 Pro보다 높습니다. 전체 배치를 진행하기 전에:
kling-v3.0-std-t2v로duration: 3에서 프롬프트를 테스트하세요.- 승인된 프롬프트에 대해서만
kling-v3.0-4k-t2v로 전환하세요. - 대부분의 출력에는
duration: 5를 사용하고, 히어로 클립에는 10~15초를 사용하세요.
가격 및 비용 추정
Novita AI는 Kling V3.0 4K에 대해 초당 과금을 사용합니다. 4K 계층의 가격은 Standard나 Pro보다 높습니다. 프로덕션 배치를 실행하기 전에 현재 초당 요금은 novita.ai/models/kling/kling-v3.0-4k-t2v 및 novita.ai/models/kling/kling-v3.0-4k-i2v에서 확인하세요.
Standard 및 Pro 계층에 대한 맥락은 Kling 3.0 출시 개요에서 해당 계층의 초당 요금을 문서화하고 있습니다. 4K 계층은 별도로 가격이 책정됩니다.
초당 모델에 대한 비용 추정 패턴:
- 클립당 길이 결정 (예: 5초)
- 초당 요금 곱하기
- 예상 승인 클립 수 곱하기
- 재시도 버퍼 추가 (프롬프트 실패 대비 10~20%)
문제 해결
task_id를 받았지만 결과가 성공하지 않음
4K 작업은 1080P보다 시간이 더 오래 걸립니다. 폴링 타임아웃을 최소 10분(max_wait=600)으로 늘리세요. 작업이 그 이상 TASK_STATUS_PROCESSING 상태로 남아 있으면 Novita 상태 페이지를 확인하거나 요청을 다시 시도하세요.
세부 정보 없이 TASK_STATUS_FAILED
가장 일반적인 원인은 프롬프트에 허용되지 않는 콘텐츠가 포함된 경우, I2V 모드에서 image_url이 유효하지 않거나 접근 불가능한 경우, 또는 지원 범위를 벗어난 duration 값입니다. 입력을 확인하고 더 간단한 프롬프트로 다시 시도하세요.
I2V 이미지 거부됨
이미지가 직접 URL(리디렉션이나 인증 장벽 없음)로 공개적으로 접근 가능한지, 형식이 .jpg/.jpeg/.png인지, 파일이 10MB 미만인지, 크기가 최소 300×300 픽셀인지 확인하세요.
예상치 못한 출력 해상도 4K 엔드포인트는 3840×2160을 대상으로 합니다. 플레이어나 다운스트림 도구에서 더 낮은 해상도를 보고하는 경우 파일을 올바르게 디코딩하고 있는지 확인하세요. API의 인코딩된 출력은 네이티브 4K여야 합니다.
속도 제한 오류 Novita AI는 API 키별로 속도 제한을 적용합니다. 높은 처리량의 배치 워크로드의 경우 속도 제한 문서를 확인하고 작업을 순차적으로 제출하거나 요청 사이에 약간의 지연을 두는 것을 고려하세요.
FAQ
kling-v3.0-4k-t2v는 어떤 해상도를 생성하나요?
두 4K 엔드포인트 모두 네이티브 3840×2160(4K UHD) 출력을 대상으로 합니다. 이는 낮은 해상도에서 업스케일링한 것이 아닌 하드웨어 렌더링입니다.
Kling V3.0 4K는 V3.0 Standard 및 Pro와 어떻게 다른가요?
Standard와 Pro는 1080P 출력을 생성합니다. 4K 엔드포인트는 네이티브 3840×2160 해상도를 추가합니다. Standard는 가장 빠르고 저렴하며, Pro는 적당한 비용으로 더 높은 시각적 품질을 추가하고, 4K는 가장 높은 해상도 옵션이며 그에 따라 가격이 책정됩니다. 길이(3~15초)와 비동기 API 형태는 세 계층 모두 동일합니다.
Standard 및 Pro와 동일한 API 키로 4K 엔드포인트를 사용할 수 있나요?
네. Novita AI의 모든 Kling V3.0 엔드포인트는 동일한 Bearer 토큰 인증을 사용합니다. 계층 간 유일한 변경 사항은 모델 ID와 엔드포인트 경로입니다.
Kling V3.0 4K는 네이티브 오디오 생성을 지원하나요?
V3.0 Standard 및 Pro 엔드포인트에서 사용할 수 있는 표준 오디오 동시 생성 플래그가 4K 계층에서도 지원될 수 있습니다. 현재 매개변수 목록( with_audio 필드 포함)은 T2V 및 I2V API 참고 페이지를 확인하세요.
4K 생성 작업에 얼마나 걸리나요?
4K 생성은 1080P보다 시간이 더 오래 걸립니다. 5초 클립의 경우 대기열 부하에 따라 최소 60~180초가 소요될 것으로 예상하세요. 폴링 로직을 최소 10분의 타임아웃으로 설계하고 TASK_STATUS_PROCESSING을 정상적인 중간 상태로 처리하세요.
I2V 엔드포인트는 제품 또는 브랜드 영상에 유용한가요?
네, 입력 이미지가 깨끗하고 조명이 좋을 때 유용합니다. I2V 엔드포인트는 고정된 피사체에 대해 첫 프레임 구성을 잘 유지합니다. 복잡한 카메라 움직임이나 여러 캐릭터 장면의 경우 전체 프로덕션 실행 전에 작은 테스트 배치를 실행하세요.
