Kling v2.1 Master
Kling v2.1 Master menjana video daripada teks atau taklimat berasaskan imej. Gunakannya untuk peristiwa visual yang ditentukan dengan jelas, dengan subjek, aksi, arahan kamera dan pengakhiran dirancang sebagai satu syot ringkas yang koheren.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Kling v2.1 Master ialah edisi video Kling dengan keupayaan teks kepada video dan imej kepada video dalam katalog model yang didokumenkan. Pilih taklimat adegan bertulis apabila mengembangkan idea visual daripada teks, atau taklimat berasaskan imej apabila subjek dan komposisi sudah ditetapkan. Dalam kedua-dua keadaan, tentukan peristiwa yang patut ditunjukkan oleh syot yang telah siap.
Untuk penciptaan berasaskan teks, terangkan subjek, latar dan aksi mengikut urutan yang jelas. Seorang penari merentasi studio, kenderaan bergerak di bawah pokok atau objek kaca menangkap perubahan cahaya masing-masing memberikan tujuan khusus kepada jujukan. Sertakan butiran yang menentukan rupa adegan dan pastikan butiran itu kekal selaras sepanjang taklimat.
Untuk penciptaan berasaskan imej, sediakan rujukan yang menunjukkan ciri yang perlu dikekalkan oleh syot. Pastikan wajah, tepi objek dan bahan yang tersendiri kelihatan. Terangkan perkara yang berubah daripada pandangan permulaan itu: gerak isyarat subjek, pergerakan persekitaran atau kedudukan kamera. Pastikan imej sumber tersedia semasa menyemak hasilnya.
Rancang aksi berdasarkan pengakhirannya. Aksi seseorang meletakkan objek patut berakhir dengan objek itu berada di tempat yang dapat dikenal pasti; penyingkapan visual patut berakhir dengan ciri penting kelihatan. Ini memudahkan pemilihan titik suntingan dan penilaian sama ada pergerakan telah memenuhi tujuannya.
Entri model yang didokumenkan merangkumi tempoh lima dan sepuluh saat, mod std dan pro, serta bentuk bingkai landskap, potret dan segi empat sama. Pilih kawalan yang tersedia dalam aliran kerja terpilih dan simpan nilai sebenarnya. Nilai klip yang terhasil berdasarkan aksi dan pembingkaian yang dikehendaki, bukan semata-mata nama edisi model.
Terangkan pergerakan subjek dan kamera secara berasingan. Untuk syot penjejakan, nyatakan subjek yang diikuti oleh kamera dan bahagian persekitaran yang patut melintasi bingkai. Untuk syot tetap, nyatakan pergerakan yang berlaku di dalamnya. Kaitkan arahan kamera dengan perkara yang perlu diperhatikan oleh penonton.
Periksa keseluruhan jujukan untuk kesinambungan. Pastikan subjek penting kekal dapat dikenali, interaksi mempunyai hubungan ruang yang koheren dan pemasaan memberikan ruang untuk potongan suntingan yang dikehendaki. Perhatikan perubahan pada tangan, wajah, butiran permukaan dan objek yang bertindih. Nilai pergerakannya serta bingkai individu yang paling baik.
Simpan setiap video yang telah siap bersama prom, rujukan dan tetapannya. Gunakan taklimat yang sama apabila membandingkan sesuatu adegan merentasi edisi, dan catat perbezaan visual sebenar. Apabila membetulkan calon, terangkan masalah yang diperhatikan dan semak semula arahan yang berkaitan dengannya sambil mengekalkan unsur adegan yang berguna.
Ailoot Ultra · Video POST /v1/videos kling-v2-1-master
kling-v2-1-masterPengenalan
Kling v2.1 Master menjana video daripada teks atau taklimat berasaskan imej. Gunakannya untuk peristiwa visual yang ditentukan dengan jelas, dengan subjek, aksi, arahan kamera dan pengakhiran dirancang sebagai satu syot ringkas yang koheren.
- Input yang diterima
- Teks
- Hasil
- Video
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Video POST /v1/videos
- Input
text- Output
video
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had kling-v2-1-master Syarat: Gunakan pemilih penghalaan Ailoot ini tepat seperti yang dinyatakan. | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang maksimum: 500 Syarat: | Lalai— |
Medanmode | Jenisstring | KeperluanDiperlukan | Nilai & had std, pro Syarat: | Lalai— |
Medanmodel_name | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Penggantian nilai asal model adalah pilihan. Abaikan untuk menggunakan model yang dipilih secara automatik; nilai yang ditetapkan secara jelas dikekalkan. | Lalai— |
Medancfg_scale | Jenisnumber | KeperluanPilihan | Nilai & had Minimum: 0 Maksimum: 1 Syarat: | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had Syarat: | Lalai— |
Medannegative_prompt | Jenisstring | KeperluanPilihan | Nilai & had Panjang maksimum: 200 Syarat: | Lalai— |
Medanduration | Jenisinteger | KeperluanPilihan | Nilai & had 5, 10 Syarat: | Lalai— |
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, mode |
Parameteroptional | Kontrakmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametermaterial_types | Kontraktext |
Parameterconditions | KontrakGunakan pemilih penghalaan Ailoot ini tepat seperti yang dinyatakan., Penggantian nilai asal model adalah pilihan. Abaikan untuk menggunakan model yang dipilih secara automatik; nilai yang ditetapkan secara jelas dikekalkan. |
Alias kaedah: /v1/videos/generations
Kitar hayat: 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}
Pelan harga
Cara caj akhir dikira
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Anggaran kadar untuk perbandingan
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $6 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
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-v2-1-master", "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.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Terima dan simpan hasil
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}
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan pengepala lengkap, pengecam asal, setiap output sebenar dan semua medan penggunaan/perakaunan. Simpan setiap aset unik milik anda dan kekalkan setiap peranan yang merujuk kepadanya.
Jika respons asal perlu disemak
Simpan id tugas atau operasi awam yang dikembalikan dan semua pengepala. Baca tugas asal sahaja; unknown atau result_pending_check tidak memberikan kebenaran untuk penciptaan lain.
Medan respons
| Medan | Jenis |
|---|---|
Medanid | Jenisstring |
Medanpolling_url | Jenisstring |
Medanprovider_task_id | Jenisstring |
Medandata.task_id | Jenisstring |
Medandata.task_status | Jenisstring |
Medandata.task_result.videos[].url | Jenisstring |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, pemilih model, jenis atau bentuk input tidak sah. | Langkah seterusnyaSemak butiran pengesahan yang dikembalikan sebelum menyediakan permintaan berasingan. |
Respons | SyaratPermintaan atau hasil asal tidak diketahui atau memerlukan semakan. | Langkah seterusnyaSimpan pengecam dan pengepala asal; baca hanya rekod status/pustaka yang disokong. Jangan hantar semula permintaan penciptaan. |
Alias
Alias model
Ailoot Ultra kling-v2-1-master
Alias laluan kaedah
/v1/videos/generations
ID pemanggil berkaitan
FAQ · Kling v2.1 Master
- Apakah input dan hasil yang tersedia?
POST /v1/videos·kling-v2-1-master:text→video- Apakah medan yang digunakan oleh permintaan?
POST /v1/videos·kling-v2-1-master:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Apakah had yang terpakai?
POST /v1/videos·kling-v2-1-master:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200