> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling v3.0 4K テキスト動画生成

Kling v3.0 4K テキストから動画生成は、テキストプロンプトに基づいて 4K 超高精細動画を生成できます。より豊かな画面ディテールを備え、自然な動きと滑らかなシーンのダイナミック表現に対応します。3〜15 秒の柔軟な長さ、音声と動画の同期生成、マルチショット動画生成をサポートしています。

<Tip>
  これは**非同期**API であり、非同期タスクの task\_id のみを返します。この task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成結果を取得してください。
</Tip>

## リクエストヘッダー

<ParamField header="Content-Type" type="string" required={true}>
  列挙値: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 認証形式: Bearer \{\{API キー}}。
</ParamField>

## リクエストボディ

<ParamField body="sound" type="boolean" default={false}>
  動画生成時に音声も同時に生成するかどうか。
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  動画を生成するためのポジティブプロンプトテキスト。シーンの動き、カメラ移動、アクション、音声スタイル、雰囲気、効果音を記述できます。2500 文字を超えることはできません。multi\_prompt とは相互排他的です。

  長さ制限：0 - 2500
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  生成動画の長さ（秒）。3〜15 秒の柔軟な長さをサポートします。

  値の範囲：\[3, 15]
</ParamField>

<ParamField body="cfg_scale" type="number" default={0.5}>
  動画生成の柔軟性を制御します。値が高いほど、モデルが生成する内容はプロンプトにより忠実になります。値が低いほど、動きの効果はより自然になります。

  値の範囲：\[0, 1]
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  生成動画のアスペクト比。

  オプション値：`16:9`, `9:16`, `1:1`
</ParamField>

<ParamField body="multi_prompt" type="string[]">
  マルチショット動画生成のプロンプトリスト。動画を複数のショットに分割します。prompt とは相互排他的です。
</ParamField>

<ParamField body="negative_prompt" type="string">
  ネガティブプロンプト。画面と音声で避けたい要素を指定します。長さは 2500 文字を超えないようにしてください。

  長さ制限：0 - 2500
</ParamField>

## レスポンス情報

<ResponseField name="task_id" type="string" required={true}>
  task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成された出力を取得します。
</ResponseField>
