Kling V3.0 4K は、Novita AI 上で 2 つの専用 API エンドポイントとして利用できます。テキストから動画へは kling-v3.0-4k-t2v、画像から動画へは kling-v3.0-4k-i2v です。どちらもネイティブ 3840×2160 の出力を生成し、3～15 秒の長さをサポートし、すべての Novita 動画 API で共通の非同期タスクパターンに従います。すでにパイプラインに Kling V3.0 Standard または Pro を使用している場合、4K ティアへの切り替えはモデル ID を 1 行変更するだけです。
このガイドでは、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 を使用する場合：
- 特定の最初のフレームを生成クリップの起点としたい
- ソース画像から一貫した被写体の外観が必要
ステップ 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": "金色の時間帯の岩場の海岸にある孤立した灯台、シネマティックなワイドショット、打ち寄せる波",
"negative_prompt": "ぼやけた、低品質、歪んだ",
"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": "灯台のビームが霧の中を掃く、ゆっくりとしたドラマチックな動き",
"negative_prompt": "高速カット、ブレ、低品質",
"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="金色の時間帯の岩場の海岸にある孤立した灯台、シネマティックなワイドショット",
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 である必要があります。 |
解像度と長さ vs コスト
4K 生成は、1 秒あたりのコストが 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 キーごとにレート制限を適用します。高スループットのバッチワークロードの場合は、レート制限ドキュメント を確認し、タスクを順次またはリクエスト間に小さな遅延を入れて送信することを検討してください。
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 の形状は 3 つのティアすべてで同じです。
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 エンドポイントは、静止した被写体に対して最初のフレームの構図をよく保持します。複雑なカメラワークや複数キャラクターのシーンの場合は、本番実行前に小さなテストバッチを実行してください。
