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 層級就很有意義。
它並非在所有使用案例上都取代 Standard 或 Pro。在較低解析度下進行迭代和提示詞測試成本更低，而且 4K 生成每個任務所需的時間也更長。一個實務的工作流程是先用 Standard 迭代，然後在最終接受提示詞時切換到 kling-v3.0-4k-t2v 或 kling-v3.0-4k-i2v。
在以下情況使用 kling-v3.0-4k-t2v：
- 場景完全可以透過提示詞描述
- 沒有參考圖片，或參考圖片不重要
在以下情況使用 kling-v3.0-4k-i2v：
- 需要特定的第一幀來錨定生成的片段
- 你需要來源圖片中一致的主體外觀
第一步：取得你的 Novita AI API 金鑰
在 novita.ai 註冊，並從控制台產生一組 API 金鑰。新帳戶包含免費額度。將金鑰儲存為環境變數 — 不要將其硬編碼在原始檔中。
export NOVITA_API_KEY="your_api_key_here"
第二步：模型 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 參考文件：
第三步：發送你的第一個請求
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 — 你需要用它來取得結果。
第四步：輪詢取得影片結果
curl "https://api.novita.ai/v3/async/task-result?task_id=t2v-kling-4k-abc123" \
-H "Authorization: Bearer $NOVITA_API_KEY"
一個完成的任務會回傳一個 task 物件，其中包含 status: "TASK_STATUS_SUCCEED" 和一個 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 需要更長的時間。
第五步：圖片轉影片請求
圖片轉影片端點除了 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。 |
解析度與長度 vs. 成本
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、檔案小於 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 端點能很好地保留靜止主體的第一幀構圖。對於複雜的攝影機運動或多角色場景，在進行完整生產運行之前，請先執行一個小型測試批次。
