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 与 Standard 和 Pro
当输出分辨率成为关键约束时——例如需要印刷级画质、大屏展示，或下游工作流要求高分辨率源帧进行合成或裁剪——4K 版本是最佳选择。
但 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" 的 task 对象以及一个 videos 数组：
{
"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 |
字符串 | 是 | 场景描述。尽量具体：主体、动态、镜头角度、光照。 |
negative_prompt |
字符串 | 否 | 需要抑制的内容：模糊、抖动、伪影、不想要的风格。 |
duration |
整数 | 否 | 视频时长（秒）。取值范围：3–15。默认值因情况而异——请查阅文档。 |
aspect_ratio |
字符串 | 否 | "16:9"、"9:16"、"1:1"。默认值："16:9"。 |
cfg_scale |
浮点数 | 否 | 提示词遵循强度。0.5 是一个安全的起始值。 |
image_url |
字符串 | 仅 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 无效或无法访问、或时长值超出支持范围。请验证输入并使用更简单的提示词重试。
I2V 图片被拒绝
请确认图片可通过直接 URL 公开访问（无重定向或认证障碍）、格式为 .jpg/.jpeg/.png、文件大小不超过 10 MB，且尺寸至少为 300×300 像素。
输出分辨率不符合预期 4K 接口目标输出为 3840×2160。如果你的播放器或下游工具报告分辨率较低，请检查其是否正确解码文件。API 的编码输出应为原生 4K。
速率限制错误 Novita AI 对每个 API 密钥应用速率限制。对于高吞吐量的批量工作负载，请查看速率限制文档，并考虑按顺序提交任务或在请求之间添加少量延迟。
常见问题
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 版本上也可能支持。请查看 T2V 和 I2V API 参考页面，了解当前参数列表，包括任何 with_audio 字段。
4K 生成任务需要多长时间？
4K 生成比 1080P 耗时更长。对于 5 秒的片段，预计至少需要 60–180 秒，具体取决于队列负载。请将轮询逻辑的超时时间设置为至少 10 分钟，并将 TASK_STATUS_PROCESSING 视为正常的中间状态。
I2V 接口适用于产品或品牌素材吗？
适用，前提是输入图片干净且光照良好。I2V 接口能够很好地保持静态主体的第一帧构图。对于复杂的摄像机运动或多角色场景，请在全面制作前先运行一个小型测试批次。
