kling-v1-6
kling-v1-6プロフィールは、文章で記述したシーンから動画を生成します。被写体、動作、カメラの方向を明確にした短いショットを計画し、文書に記載された五秒または十秒の長さを使用します。生成は非同期です。返されたタスクの識別情報を保持し、元のタスクが成功した後で完成動画を取得してください。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
正確な選択識別子kling-v1-6は、Klingのテキストから動画を生成するプロフィールを示します。modelをkling-v1-6に設定し、文章によるシーンをpromptに入れたJSONをPOST /v1/videos/generationsに送信します。POST /v1/videosも同じ生成リクエストを受け付けます。明確なリクエストは、何が見え、ショット中に何が起こり、カメラがどう捉えるかを説明します。最小限のシーンリクエストは、モデルの選択識別子とpromptを渡し、追加のショット設定を指定しません。
商品ショットなら、物体、置かれる面、照明と、ゆっくり回転する、カメラ位置が変わるといった目に見える主な動作を記述します。シーンのコンセプトなら、舞台、主要な被写体、画面内の動きを指定します。要求するクリップ内で動作を読み取りやすく保ってください。たとえば、静かな湖を横切る小舟、岸からの広い視野、早朝の光、舟の進む方向を追う安定したカメラを記述できます。
promptの上限は500文字です。省略可能なnegative_promptは最大200文字で、不要な要素を説明します。このプロフィールで文書に記載されたdurationは5秒と10秒です。mode値はstdとproです。cfg_scaleは0から1の数値で、文書では値が高いほどテキストへの追従が強くなると説明されています。目的のショットに合わせて設定を選び、送信した値を結果とともに保持してください。
文書に記載されたcamera_controlオブジェクトには、simple、down_back、forward_up、right_turn_forward、left_turn_forwardのカメラ種別があります。simpleの設定にはhorizontal、vertical、pan、tilt、roll、zoomが記載されています。独立したカメラ制御オブジェクトなしでシーンを説明できる場合は、最小限のテキスト例が出発点になります。被写体を見せる、動きを追うなど、プロンプトでカメラ移動の目的を明確にしてください。
送信すると非同期タスクが開始されます。返されたid、X-Ailoot-Task-Idヘッダー、polling_urlを保持し、同じAiloot APIキーを使ってそのpolling_urlにGETを送り、元のタスクを読み取ります。タスク状態はdata.task_statusにあり、submittedとprocessingは完了待ち、succeedは成功、failedは失敗です。したがって、送信の受領確認は途中結果です。成功したら、data.task_result.videos[].url内のURLをすべて取得します。これらはAilootが管理する結果ファイルのリンクです。GET /v1/videos/{id}/contentは最初の出力を取得し、indexクエリパラメータで返された出力をゼロ始まりのインデックスで選択できます。選んだクリップとともに状態応答を保持してください。タイムアウトやresult_pending_check応答が発生した場合は、元の識別情報を保持し、ショットを再送せずにその操作を確認します。
完成した映像を最初から最後まで確認してください。意図する動作、被写体の外観、フレーミング、動きはすべてショットの制作指示に含まれます。この正確なプロフィールは、ここで説明したテキストから動画へのワークフローを提供します。状態確認がまだ必要な返却タスクは、クライアントのリクエストがタイムアウトした場合も、元の識別情報で追跡してください。新たな生成リクエストを検討する前に、そのタスク情報を保持します。
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6はじめに
kling-v1-6プロフィールは、文章で記述したシーンから動画を生成します。被写体、動作、カメラの方向を明確にした短いショットを計画し、文書に記載された五秒または十秒の長さを使用します。生成は非同期です。返されたタスクの識別情報を保持し、元のタスクが成功した後で完成動画を取得してください。
- 対応する入力
- テキスト
- 結果
- 動画
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · Video POST /v1/videos
- 入力の種類
text- 出力の種類
video
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 kling-v1-6 | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドmode | 種類string | 要件必須 | 値と制限 std, pro | デフォルト— |
フィールドmodel_name | 種類string | 要件任意 | 値と制限 kling-v1-6 | デフォルト— |
フィールドcfg_scale | 種類number | 要件任意 | 値と制限 最小値: 0 最大値: 1 | デフォルト— |
フィールドaspect_ratio | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドnegative_prompt | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドduration | 種類integer | 要件任意 | 値と制限 5, 10 | デフォルト— |
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, prompt, mode |
パラメータoptional | 仕様model_name, cfg_scale, aspect_ratio, negative_prompt, duration |
パラメータmaterial_types | 仕様text |
パラメータconditions | 仕様model selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
メソッドのエイリアス: /v1/videos/generations
ライフサイクル: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
料金
最終料金の計算方法
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値（default）を使用する場合
比較用の推定料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 料金 |
|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定Estimated generation cost | 料金表— | 予測数量生成1回分の概算 | 料金 入力 · 推定生成コスト · 比較専用の見積もり $6 生成前の見積もり This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
結果を受け取って保存
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
完了した結果をすべて保存
完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。
Retain the complete response, all actual results, original identifiers, usage and response headers.
元のレスポンスを確認する場合
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドdata.task_result.videos[].url | 種類string or array, as returned |
エイリアス
モデルのエイリアス
Ailoot Ultra kling-v1-6
メソッドパスのエイリアス
/v1/videos/generations
関連する呼び出し用ID
FAQ · kling-v1-6
- 利用できる入力と結果は何ですか？
POST /v1/videos·kling-v1-6:text→video- リクエストはどの項目を使用しますか？
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- どの制限が適用されますか？
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1