Kling: Video v3.0 Standard
Kling VIDEO 3.0 Standard 是快手的 720p 影片規格,接受文字與圖片簡述。可建立三至十五秒場景,具備原生音訊、主體參考、首尾影格引導,以及單鏡頭或多鏡頭敘事。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。
Kling VIDEO 3.0 Standard 是快手以文字或提供的圖片生成影片場景的 720p 規格。它採用 VIDEO 3.0 版本的原生音訊、主體參考與多鏡頭敘事,片長可在三至十五秒間彈性選擇。此規格適合發展視覺方向、預覽短篇敘事,或製作動作及聲音明確的精簡場景。
文字引導場景需確立主體、場景、動作、光線與攝影機行為。圖片引導場景則需準備清楚顯示預期動畫外觀及構圖的開場圖片。一份原創簡述可以呈現角色站在工作坊桌旁,再描述角色拿起小物件,攝影機同時靠近動作。文字中請將主體動作與攝影機移動分開。
多鏡頭生成可根據場景描述自動規劃拍攝角度。自訂多鏡頭指示則為個別鏡頭分配內容與時長。原廠自訂鏡頭規格接受一至六個鏡頭,每鏡最多 512 個字元,至少一秒。各鏡頭時長合計必須等於總片長。若單一連續視角已能清楚傳達場景,使用單鏡頭簡述可避免不必要的轉場。
短分鏡可先交代場景,再進入動作,最後以細節解釋結果。請指定每鏡保留哪些主體,以及構圖如何改變。自動模式可依場景調整拍攝安排;自訂序列則能為各部分提供明確指示。原廠參考文件的一般單一提示詞最多接受 2,500 個字元。
主體參考控制有助於固定角色、物件與場景。使用清晰參考素材,為每個主體提供穩定描述。文件中的圖片引導規格允許最多三個預先準備的元素。若製作插畫式產品場景,一份參考可確立物件,開場構圖交代它的位置,動作簡述再描述周圍發生的事件。請檢查整段鏡頭中的完成外觀,不要假設參考能防止所有變化。
首尾影格可引導受圖片約束的轉變,走向所需最終構圖。使用能傳達合理連接的影格,並描述其間動作。原廠圖片規格接受 JPG、JPEG 與 PNG,檔案不超過 10 MB,尺寸至少 300 像素;起始圖片長寬比必須介於 1:2.5 與 2.5:1。請為該工作準備影格素材,不要將分鏡描述視為可互換的輸入素材組。
啟用相應模式時,Standard 可生成原生音訊;原廠參考文件預設關閉音訊。請將台詞、氣氛及相關聲音一併描述為場景內容。VIDEO 3.0 支援中文、英文、日文、韓文與西班牙文語音處理,包括語碼切換及支援的口音或方言。原廠指南指出,以其他語言輸入的對話會翻譯成英文。多角色場景需明確指出說話主體,並讓台詞長度符合預期演出。
一份原創對話簡述可為說話者 A 指定台詞、為說話者 B 指定可見反應,並安排跟隨對話的視角變化。場景聲音應與對話分開描述,避免背景音效變成語意不明的語音指示。以參考素材確立主體外觀,再以文字確立他們的動作及台詞。
可見文字也是 3.0 流程的一部分。來源圖片可能包含在動畫中需要維持外觀的招牌、字幕或產品標籤。請指出該文字及其場景用途,再檢查結果的拼字、可讀性與穩定性。短篇行銷視覺應將重要訊息放在醒目位置,不要依賴非常小的背景標籤。
Standard 輸出為 720p。Pro 是另行選擇的 1080p 規格;原生 4K 是另一種原廠模式,不是 Standard 的自動設定。文字引導的長寬比選項包括 16:9、9:16 與 1:1。請依預定版位選擇格式與構圖,並在比較動作、光線或鏡頭順序變更時維持相同視覺方向。
完成生成會提供影片素材與實際片長。原廠結果文件指出,生成影片會在 30 天後刪除,因此請儘速保存完成短片。將場景簡述、參考圖片與所選規格一併保存,讓後續修訂具有一致起點。請在短片實際使用情境中檢查視覺動作、主體連續性、攝影機拍攝安排、對話及文字。針對未達標細節集中修正,比用無關指示替換整份場景簡述更有用。
Ailoot Ultra · 影片 POST /v1/videos kwaivgi/kling-v3.0-std
kwaivgi/kling-v3.0-std入門
Kling VIDEO 3.0 Standard 是快手的 720p 影片規格,接受文字與圖片簡述。可建立三至十五秒場景,具備原生音訊、主體參考、首尾影格引導,以及單鏡頭或多鏡頭敘事。
- 接受的輸入
- 文字 · 圖片
- 結果
- 影片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · 影片 POST /v1/videos
- 輸入
text,image- 輸出
video- 輸出格式
- 原始 MP4 位元組;不進行正規化或轉碼
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 kwaivgi/kling-v3.0-std | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 | 預設值— |
欄位duration | 類型integer | 要求必填 | 值與限制 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 最小值: 1 最大值: 600 | 預設值— |
欄位resolution | 類型string | 要求選填 | 值與限制 720p | 預設值— |
欄位aspect_ratio | 類型string | 要求選填 | 值與限制 16:9, 9:16, 1:1 | 預設值— |
欄位generate_audio | 類型boolean | 要求選填 | 值與限制 false, true 條件: 省略此選項會選用含音訊的價格。設為 false 則會選用不含音訊的價格。請查看結果中的 has_audio,確認是否回傳音軌。 | 預設值— |
欄位frame_images | 類型array | 要求選填 | 值與限制 項目數下限: 1 項目數上限: 2 輸入內容: 影格物件陣列。每個物件包含 type=image_url、內含 url 的 image_url,以及 frame_type。請使用 HTTPS 圖片 URL,並將 frame_type 設為 first_frame 或 last_frame。每種影格角色最多只能出現一次。 確切鍵名: type, image_url, frame_type 條件: 這些鍵描述每個影格物件;image_url 僅包含 url。僅含文字的請求請省略 frame_images。 | 預設值— |
欄位input_references | 類型array | 要求選填 | 值與限制 | 預設值— |
欄位size | 類型string | 要求選填 | 值與限制 1280x720, 720x1280, 720x720 模式: ^[1-9][0-9]*x[1-9][0-9]*$ | 預設值— |
欄位callback_url | 類型string | 要求選填 | 值與限制 模式: ^https:// | 預設值— |
欄位session_id | 類型string | 要求選填 | 值與限制 | 預設值— |
欄位trace | 類型object | 要求選填 | 值與限制 | 預設值— |
欄位user | 類型string | 要求選填 | 值與限制 | 預設值— |
輸入素材組合
文字生成影片 · 文字提示詞。 · 必填: model, prompt, duration
請以文字提供 prompt,並以整數秒提供 duration。請選擇支援的解析度,並指定長寬比或使用列出的大小。
model: 類型: string · kwaivgi/kling-v3.0-std
prompt: 類型: string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是
圖片生成影片 · 文字提示詞與首格圖片。 · 必填: model, prompt, duration, frame_images
frame_images 是陣列。每個影格物件包含 type、image_url 與 frame_type;image_url 內含 url。請將 type 設為 image_url,並使用 first_frame;last_frame 為選填。每種影格角色最多只能出現一次。請為每個影格提供公開的 HTTPS 圖片 URL。請選擇支援的解析度,並指定長寬比或使用列出的大小。
確切鍵名: type, image_url, frame_type
model: 類型: string · kwaivgi/kling-v3.0-std
prompt: 類型: string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt, duration |
參數material_types | 規格text, image |
參數additional_properties | 規格false |
參數optional_controls | 規格resolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
生命週期: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
方案
最終費用的計算方式
顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
供比較的預估費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 費用項目 | 參考解析度 | 參考模式 | 參考音訊 | 計費單位 | 計費條件 | 費用 |
|---|---|---|---|---|---|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 費用項目— | 參考解析度— | 參考模式— | 參考音訊— | 計費單位— | 計費條件— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取,1 小時 · 僅供比較的估算 — / 1K Token |
| 設定影片輸出 · 參考費率 | 費率表— | 預估數量— | 費用項目reference_output_rate | 參考解析度— | 參考模式— | 參考音訊— | 計費單位每秒輸出 | 計費條件— | 費用 輸出 · 輸出影片每秒參考費率 · 僅供比較的估算 $0.168 每秒輸出 |
| 設定影片價格 | 費率表— | 預估數量— | 費用項目— | 參考解析度— | 參考模式— | 參考音訊— | 計費單位每秒影片 | 計費條件音訊:with_audio | 費用 輸出 · 影片價格 · 僅供比較的估算 $0.252 每秒影片 |
| 設定圖片生成影片(影格圖片)· 1080p · 參考費率 | 費率表— | 預估數量— | 費用項目reference_output_rate | 參考解析度1080p | 參考模式以圖生影片(影格圖片) | 參考音訊不含音訊 | 計費單位每秒輸出 | 計費條件— | 費用 輸出 · 輸出影片每秒參考費率 · 僅供比較的估算 $0.168 每秒輸出 |
| 設定影片價格 | 費率表— | 預估數量— | 費用項目— | 參考解析度— | 參考模式— | 參考音訊— | 計費單位每秒影片 | 計費條件生成模式:image_to_video;解析度:720p | 費用 輸出 · 影片價格 · 僅供比較的估算 $0.168 每秒影片 |
| 設定文字生成影片 · 1080p · 參考費率 | 費率表— | 預估數量— | 費用項目reference_output_rate | 參考解析度1080p | 參考模式文字生成影片 | 參考音訊不含音訊 | 計費單位每秒輸出 | 計費條件— | 費用 輸出 · 輸出影片每秒參考費率 · 僅供比較的估算 $0.168 每秒輸出 |
| 設定文字生成影片 · 480p · 參考費率 | 費率表— | 預估數量— | 費用項目reference_output_rate | 參考解析度480p | 參考模式文字生成影片 | 參考音訊不含音訊 | 計費單位每秒輸出 | 計費條件— | 費用 輸出 · 輸出影片每秒參考費率 · 僅供比較的估算 $0.168 每秒輸出 |
| 設定影片價格 | 費率表— | 預估數量— | 費用項目— | 參考解析度— | 參考模式— | 參考音訊— | 計費單位每秒影片 | 計費條件生成模式:text_to_video;解析度:720p | 費用 輸出 · 影片價格 · 僅供比較的估算 $0.168 每秒影片 |
| 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 費用項目— | 參考解析度— | 參考模式— | 參考音訊— | 計費單位— | 計費條件— | 費用 輸出 · 預估生成費用 · 僅供比較的估算 $0.504 生成前估算 此估算並非額外費用,也不是本次生成完成後的固定費率。 |
Ailoot 會在請求前預留估算金額。取得結果後,依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
參考費率詳情
模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。
影片設定的價格參考
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 計費條件 | 費用 |
|---|---|---|
| 設定影片價格 | 計費條件此定價鍵未宣告額外條件。 | 費用 輸出 · 影片價格 $0.168 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
| 設定影片價格 | 計費條件音訊:with_audio | 費用 輸出 · 影片價格 $0.252 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
| 設定影片價格 | 計費條件生成模式:text_to_video;解析度:480p | 費用 輸出 · 影片價格 $0.168 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
| 設定影片價格 | 計費條件生成模式:text_to_video;解析度:720p | 費用 輸出 · 影片價格 $0.168 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
| 設定影片價格 | 計費條件生成模式:image_to_video;解析度:720p | 費用 輸出 · 影片價格 $0.168 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
| 設定影片價格 | 計費條件生成模式:text_to_video;解析度:1080p | 費用 輸出 · 影片價格 $0.168 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
| 設定影片價格 | 計費條件生成模式:image_to_video;解析度:1080p | 費用 輸出 · 影片價格 $0.168 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 |
請求範例
Ailoot Ultra · 影片
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-std","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
接收並儲存結果
Ailoot Ultra · 影片
自有內容的簽署 URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
查看工作狀態
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
其他內容讀取方式
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
保留所有已完成的結果
請儲存每部已完成的影片或傳回的檔案,並從實際傳回的每個素材 URL 取得素材。
請保留每個實際的自有輸出,以及回傳的實測中繼資料。
需要檢查原始回應時
503 result_pending_check + 原始 id + X-Should-Retry:false;切勿重送原始請求
回應欄位
| 欄位 | 類型 | 含義 |
|---|---|---|
欄位index | 類型integer | 含義此影片在輸出清單中的位置,索引從零開始。 |
欄位content_url | 類型string | 含義此已完成影片的簽署 HTTPS 下載 URL。 |
欄位sha256 | 類型string | null | 含義原始影片位元組的 SHA-256 摘要;無法取得時為 null。 |
欄位size_bytes | 類型integer | null | 含義原始影片檔案大小,以位元組為單位;無法取得時為 null。 |
欄位duration_ms | 類型integer | null | 含義實測的影片長度,以毫秒為單位;無法取得時為 null。 |
欄位width | 類型integer | null | 含義影片寬度,以像素為單位;無法取得時為 null。 |
欄位height | 類型integer | null | 含義影片高度,以像素為單位;無法取得時為 null。 |
欄位video_codec | 類型string | null | 含義影片編碼識別碼;未記錄時為 null。 |
欄位has_audio | 類型boolean | null | 含義影片是否包含音軌;未測量時為 null。 |
欄位audio_codec | 類型string | null | 含義音訊編碼識別碼;未記錄識別碼時為 null。 |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應404 · not_found_error | 條件無法存取影片,或找不到此影片 ID。 | 下一步請確認影片存取權限。若影片已存在,請使用其原始公開 ID 與相同的 API 金鑰。 |
回應401 · authentication_error | 條件API 金鑰與已驗證的帳號不符。 | 下一步提交前,請先確認 API 金鑰與帳號存取權限。 |
回應400 · invalid_request_error | 條件無法讀取請求,或下載索引無效。 | 下一步請修正請求本文。若要下載,請選擇原始工作回傳的輸出索引。 |
回應422 · price_unavailable | 條件所選影片設定無法定價。 | 下一步請選擇支援的影片設定,填妥其必要選項,再提交修正後的請求。 |
回應422 · invalid_request_error | 條件影片輸入或原始延續工作無效。 | 下一步請使用有效的 HTTPS 輸入。若要延續影片,請使用已完成原始影片的公開影片 ID,以及相同的 API 金鑰。 |
回應402 · billing_error | 條件可用餘額或限制不允許預留額度。 | 下一步傳送新的請求前,請先確認可用餘額與限制。 |
回應503 · server_error | 條件影片驗證、儲存系統或服務存取暫時無法使用。 | 下一步請等待服務恢復可用。若已有影片 ID,請查詢該原始工作,切勿另行建立生成工作。 |
回應503 · result_pending_check | 條件原始影片結果與費用需要查核。 | 下一步請保留回傳的影片 ID,並查詢該工作。查詢期間切勿傳送替代的生成請求。 |
回應503 · owned_result_unavailable | 條件現有影片暫時無法下載。 | 下一步請稍後查詢同一影片工作,並下載其現有輸出。新的生成請求會建立獨立操作。 |
回應409 · video_not_ready | 條件影片內容尚未發布。 | 下一步請查詢原始工作狀態。回報 completed 後再下載;若回報 failed,請依其費用查核通知處理。 |
別名
模型別名
Ailoot Ultra kwaivgi/kling-v3.0-std
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Kling: Video v3.0 Standard
- 可以使用哪些輸入與結果?
POST /v1/videos·kwaivgi/kling-v3.0-std:text,image→video- 請求使用哪些欄位?
POST /v1/videos·kwaivgi/kling-v3.0-std:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- 適用哪些限制?
POST /v1/videos·kwaivgi/kling-v3.0-std:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1