Kling v1.5
Kling v1.5 ialah model video dengan aliran kerja imej kepada video yang didokumenkan. Mulakan dengan imej pegun yang telah disediakan dan terangkan pergerakan, sudut pandang serta komposisi akhir untuk syot ringkas watak, objek atau persekitaran.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Kling v1.5 ialah edisi penjanaan video Kling dengan keupayaan imej kepada video dalam katalog model yang didokumenkan. Imej pegun yang dibekalkan menyediakan titik mula visual, manakala taklimat bertulis menerangkan bagaimana adegan patut bergerak. Gunakannya untuk mengembangkan gerak isyarat watak, objek yang bergerak atau persekitaran yang berubah daripada imej yang komposisinya sudah sesuai dengan syot.
Sediakan imej dengan menumpukan butiran penting subjek. Watak memerlukan wajah, pose dan pakaian yang jelas; objek memerlukan garis bentuk yang jelas dan ciri bahan yang kelihatan. Tinggalkan ruang dalam komposisi untuk pergerakan yang dikehendaki. Simpan imej pegun asal bersama jujukan yang telah siap supaya perubahan rupa boleh dinilai secara langsung.
Tulis aksi sebagai peristiwa yang dapat diperhatikan. Contohnya, terangkan seseorang yang sedang duduk berpaling ke arah tingkap atau reben fabrik yang bergerak ditiup angin sepoi-sepoi. Nyatakan arah dan pengakhiran yang dikehendaki. Apabila beberapa objek muncul, kenal pasti objek yang melakukan aksi dan objek yang kekal di tempatnya.
Jelaskan peranan kamera. Sudut pandang tetap boleh memudahkan gerak isyarat kecil diperiksa, manakala sudut pandang bergerak boleh memperlihatkan sisi baharu adegan. Terangkan pergerakan itu dalam hubungannya dengan subjek. Permintaan untuk menghampiri subjek dan permintaan supaya subjek menghampiri kamera membawa tujuan visual yang berbeza.
Entri imej kepada video yang didokumenkan menyenaraikan pilihan tempoh lima dan sepuluh saat, mod std dan pro, serta pembingkaian landskap, potret dan segi empat sama. Pilih tetapan yang ditawarkan untuk aliran kerja terpilih sebelum menilai hasilnya. Simpan mod, tempoh dan bentuk bingkai sebenar bersama imej sumber dan prom semasa membandingkan calon syot.
Untuk persembahan objek, tentukan ciri visual yang patut didedahkan oleh pergerakan itu. Ciri tersebut mungkin permukaan yang memantulkan cahaya, lipatan bahan atau bentuk pemegang. Pastikan aksi cukup tertumpu supaya ciri penting kekal kelihatan. Nilai objek sepanjang pergerakan dan pada pandangan akhir yang digunakan dalam suntingan.
Untuk adegan watak, terangkan satu gerak isyarat yang bermakna dan hubungan watak dengan objek berdekatan. Semak wajah, tangan, pakaian dan perkadaran tubuh sepanjang masa. Periksa sama ada gerak isyarat mencapai pengakhiran yang dikehendaki dan sama ada susunan unsur latar depan dan latar belakang dalam adegan kekal koheren.
Simpan keseluruhan klip yang dijana dan bahan sumbernya. Semak pembukaan, aksi utama dan pengakhiran sebagai satu jujukan, kemudian buat semakan berdasarkan ketidakpadanan yang khusus. Catatan seperti “watak berpaling menjauhi tingkap” memberikan pembetulan khusus untuk taklimat seterusnya sambil mengekalkan bahagian adegan yang lain.
Ailoot Ultra · Video POST /v1/videos kling-v1-5
kling-v1-5Pengenalan
Kling v1.5 ialah model video dengan aliran kerja imej kepada video yang didokumenkan. Mulakan dengan imej pegun yang telah disediakan dan terangkan pergerakan, sudut pandang serta komposisi akhir untuk syot ringkas watak, objek atau persekitaran.
- Input yang diterima
- Teks · Imej
- Hasil
- Video
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Video POST /v1/videos
- Input
text,image- Output
video
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had kling-v1-5 Syarat: Gunakan pemilih penghalaan Ailoot ini tepat seperti yang dinyatakan. | Lalai— |
Medanmode | Jenisstring | KeperluanPilihan | Nilai & had std, pro Syarat: Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan. | Lalaistd |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 16:9, 9:16, 1:1 Syarat: Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan. | Lalai— |
Medanduration | Jenisinteger | KeperluanPilihan | Nilai & had 5, 10 Syarat: Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan. | Lalai— |
Medanend_image | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan. | Lalai— |
Medanimage | Jenisstring or array<string> | KeperluanDiperlukan | Nilai & had Syarat: Berikan URL imej anda yang sebenar dan boleh dicapai. Senarai hanya diterima jika skema parameter menetapkan tatasusunan. | Lalai— |
Medannegative_prompt | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan. | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Syarat: Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan. | Lalai— |
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, image |
Parameteroptional | Kontrakmode, aspect_ratio, duration, end_image, negative_prompt |
Parametermaterial_types | Kontraktext, image |
Parameterconditions | KontrakGunakan pemilih penghalaan Ailoot ini tepat seperti yang dinyatakan., Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan., Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan., Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan., Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan., Berikan URL imej anda yang sebenar dan boleh dicapai. Senarai hanya diterima jika skema parameter menetapkan tatasusunan., Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan., Gunakan medan yang didokumentasikan dan pilihan yang disenaraikan untuk model yang dipilih; abaikan nilai pilihan yang tidak ditetapkan. |
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
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-5", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
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 |
Medantask_id | Jenisstring |
Medanstatus | Jenisstring |
Medanvideo_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-v1-5
Alias laluan kaedah
/v1/videos/generations
ID pemanggil berkaitan
FAQ · Kling v1.5
- Apakah input dan hasil yang tersedia?
POST /v1/videos·kling-v1-5:text,image→video- Apakah medan yang digunakan oleh permintaan?
POST /v1/videos·kling-v1-5:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt