kling-v1-6
kling-v1-6規格可根據書面場景描述生成影片。請使用文件所列的五秒或十秒時長選項，規劃主體、動作與運鏡方向清楚的短鏡頭。生成採非同步方式：請保留回傳的工作識別資訊，並在原始工作成功後取得完成影片。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
確切選擇器kling-v1-6識別的是Kling文生影片規格。請將JSON提交至POST /v1/videos/generations，model設為kling-v1-6，並在prompt中提供書面場景。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 調整值時
供比較的預估費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 — / 1K Token |
| 設定Estimated generation cost | 費率表— | 預估數量單次生成估算值 | 費用 輸入 · 預估生成費用 · 僅供比較的估算 $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