Kling AI テキストから動画生成 は何をしますか?
概要
テキストプロンプトから /v1/videos/text2video エンドポイントを使用して動画を生成します。モデル v1 から v2.6、標準/プロフェッショナルモード、カメラ制御、ネガティブプロンプト、ネイティブオーディオ(v2.6+)をサポートしています。
エンドポイント: POST https://api.klingai.com/v1/videos/text2video
リクエストパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
model_name | string | はい | モデルバージョン(モデルカタログを参照) |
prompt | string | はい | 動画の説明、最大2500文字 |
negative_prompt | string | いいえ | 生成から除外する内容 |
duration | string | はい | "5" または "10" 秒 |
aspect_ratio | string | いいえ | "16:9"(デフォルト)、"9:16"、"1:1" など |
mode | string | いいえ | "standard"(デフォルト)または "professional" |
cfg_scale | float | いいえ | プロンプトへの忠実度(0.0~1.0、デフォルト 0.5) |
camera_control | object | いいえ | カメラ移動設定 |
callback_url | string | いいえ | 完了通知用のWebhook URL |
完全な例 — Python
import jwt, time, os, requests
BASE = "https://api.klingai.com/v1"
def get_headers():
ak, sk = os.environ["KLING_ACCESS_KEY"], os.environ["KLING_SECRET_KEY"]
token = jwt.encode(
{"iss": ak, "exp": int(time.time()) + 1800, "nbf": int(time.time()) - 5},
sk, algorithm="HS256", headers={"alg": "HS256", "typ": "JWT"}
)
return {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
# テキストから動画生成タスクを作成
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Aerial drone shot of a coral reef at golden hour, "
"tropical fish swimming through crystal clear water, "
"sun rays penetrating the surface, cinematic 4K",
"negative_prompt": "blurry, low quality, distorted, watermark",
"duration": "5",
"aspect_ratio": "16:9",
"mode": "professional",
"cfg_scale": 0.5,
})
task = response.json()
task_id = task["data"]["task_id"]
# 完了をポーリング
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/text2video/{task_id}", headers=get_headers()
).json()
status = result["data"]["task_status"]
if status == "succeed":
video = result["data"]["task_result"]["videos"][0]
print(f"Video URL: {video['url']}")
print(f"Duration: {video['duration']}s")
break
elif status == "failed":
raise RuntimeError(result["data"]["task_status_msg"])
# else: submitted/processing — ポーリング継続
カメラ制御を使用する場合
# カメラ移動タイプ: pan, tilt, zoom, roll
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "A medieval castle on a cliff at sunrise, fog in the valley",
"duration": "5",
"mode": "standard",
"camera_control": {
"type": "simple",
"config": {
"horizontal": 5, # パン右(負の値は左)、範囲 -10 ~ 10
"vertical": 0, # チルト(負の値は下、正の値は上)
"zoom": 3, # ズームイン(正の値)またはアウト(負の値)
"roll": 0, # 回転
"pan": 0, # ドリー左右
"tilt": -2, # ドリー上下
}
},
})
ルール: type: "simple" の場合、config 内のフィールドは1つだけ非ゼロにします。
ネイティブオーディオを使用する場合(v2.6のみ)
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "A jazz band performing in a dimly lit club, saxophone solo, "
"audience clapping, warm amber lighting",
"duration": "10",
"mode": "professional",
"motion_has_audio": True, # 同期オーディオを生成
})
プロンプトエンジニアリングのヒント
| テクニック | 例 |
|---|---|
| シーン + アクション + スタイル | "A samurai walking through cherry blossoms, cinematic slow motion" |
| 照明の指定 | "golden hour", "neon-lit", "overcast diffused light" |
| カメラ表現 | "close-up", "wide establishing shot", "tracking shot" |
| ネガティブプロンプト | "blurry, watermark, text overlay, distorted faces" |
| 素材/テクスチャ | "brushed steel", "hand-painted watercolor", "photorealistic" |
コスト表
| 時間 | スタンダード | プロフェッショナル |
|---|---|---|
| 5 秒 | 10 クレジット | 35 クレジット |
| 10 秒 | 20 クレジット | 70 クレジット |
エラーハンドリング
| エラー | 原因 | 修正方法 |
|---|---|---|
400 無効なプロンプト | 空または2500文字を超えている | プロンプトの長さを確認 |
400 無効なモデル | サポートされていない model_name | カタログから有効なモデルIDを使用 |
402 クレジット不足 | クレジットが足りない | アカウントにチャージ |
task_status: failed | コンテンツポリシー違反または複雑すぎる | プロンプトを簡略化、制限されたコンテンツを削除 |
前提条件
- 承認されたブリーフ、権利がクリアされたまたは合成された参考資料、承認済みのワークスペースと予算、コンテンツポリシーレビュー、公開と削除のための指名された所有者が必要です。
手順
- 承認されたブリーフからサンドボックスドラフトを作成します。プライベートな個人、保護された素材、または未確認の主張をプロンプトやアップロードに含めないでください。
- 提出前に、要求された時間、スタイル、出力先、クレジット予算、コンテンツポリシーステータス、およびドラフト専用設定を確認します。
- ポリシー、権利、品質について、透かし入りのカナリアレンダリングを1つレビューします。ポリシーまたは帰属に関する懸念がある場合は停止し、公開せずにドラフトを削除します。
- 所有者の承認後にのみ公開し、編集済みの本番レシートを保持します。承認された保存期間の終了時に一時的なアセットを削除します。
出力
ブリーフID、承認されたソース分類、モデル/モード、時間、クレジット見積もり、ポリシーおよび権利レビュー結果、ドラフト出力先、承認者、保存/削除の参照、タスクIDを含むレンダリングレシートを生成します。プロンプトテキスト、ID、認証情報は除外します。
例
brief=synthetic-product-demo; source=rights-cleared; mode=standard; duration=5s; policy=pass; destination=draft-only; approval=pending; cleanup=24h は安全なカナリアリクエストです。