Kling v2.1 Master
Kling v2.1 Master menghasilkan video dari teks atau arahan berbasis gambar. Gunakan untuk peristiwa visual yang terdefinisi, dengan subjek, tindakan, arahan kamera, dan bagian akhir yang direncanakan sebagai satu pengambilan gambar singkat yang selaras.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Kling v2.1 Master adalah edisi video Kling dengan kemampuan teks ke video dan gambar ke video dalam katalog model yang didokumentasikan. Pilih arahan adegan tertulis saat mengembangkan gagasan visual dari teks, atau arahan berbasis gambar saat subjek dan komposisi sudah ditetapkan. Dalam kedua cara tersebut, tentukan peristiwa yang harus ditampilkan dalam pengambilan gambar yang telah selesai.
Untuk pembuatan berbasis teks, jelaskan subjek, latar, dan tindakan dalam urutan yang jelas. Penari yang melintasi studio, kendaraan yang bergerak di bawah pepohonan, atau benda kaca yang menangkap cahaya yang berubah masing-masing memberi tujuan yang spesifik pada rangkaian tersebut. Sertakan rincian yang menentukan penampilan adegan dan jaga agar tetap konsisten sepanjang arahan.
Untuk pembuatan berbasis gambar, siapkan referensi yang memperlihatkan ciri yang perlu dipertahankan dalam pengambilan gambar. Jaga agar wajah, tepi objek, dan bahan yang khas tetap terlihat. Jelaskan apa yang berubah dari tampilan awal tersebut: gestur subjek, gerakan lingkungan, atau posisi kamera. Sediakan gambar sumber saat meninjau hasilnya.
Rencanakan tindakan dengan mempertimbangkan bagian akhirnya. Orang yang meletakkan objek harus mengakhiri tindakan dengan objek tersebut berada di tempat yang dapat dikenali; pengungkapan visual harus berakhir dengan ciri penting terlihat. Hal ini memudahkan pemilihan titik penyuntingan dan penilaian apakah gerakan telah memenuhi tujuannya.
Entri model yang didokumentasikan mencakup durasi lima dan sepuluh detik, mode std dan pro, serta bentuk bingkai lanskap, potret, dan persegi. Pilih kontrol yang tersedia dalam alur kerja yang dipilih dan simpan nilai yang benar-benar digunakan. Nilai klip hasilnya berdasarkan tindakan dan pembingkaian yang diinginkan, alih-alih berdasarkan nama edisi model.
Jelaskan gerakan subjek dan kamera secara terpisah. Untuk pengambilan gambar dengan kamera mengikuti subjek, nyatakan subjek mana yang diikuti dan bagian lingkungan mana yang harus melintas dalam bingkai. Untuk pengambilan gambar dengan kamera diam, nyatakan gerakan yang berlangsung di dalamnya. Kaitkan arahan kamera dengan hal yang perlu diperhatikan penonton.
Periksa seluruh rangkaian untuk menilai kesinambungannya. Pastikan subjek penting tetap dapat dikenali, interaksi selaras secara spasial, dan pengaturan waktunya memberi ruang untuk titik potong yang diinginkan. Amati perubahan pada tangan, wajah, detail permukaan, dan objek yang saling tumpang tindih. Nilai gerakan sekaligus bingkai tunggal yang paling kuat.
Simpan setiap video yang telah selesai bersama prompt, referensi, dan pengaturannya. Gunakan arahan yang sama saat membandingkan satu adegan di berbagai edisi, dan catat perbedaan visual yang benar-benar terlihat. Saat memperbaiki kandidat, jelaskan masalah yang diamati dan revisi instruksi yang terkait sambil mempertahankan elemen adegan yang berguna.
Ailoot Ultra · Video POST /v1/videos kling-v2-1-master
kling-v2-1-masterMulai
Kling v2.1 Master menghasilkan video dari teks atau arahan berbasis gambar. Gunakan untuk peristiwa visual yang terdefinisi, dengan subjek, tindakan, arahan kamera, dan bagian akhir yang direncanakan sebagai satu pengambilan gambar singkat yang selaras.
- Masukan yang diterima
- Teks
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Video POST /v1/videos
- Masukan
text- Keluaran
video
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan kling-v2-1-master Kondisi: Gunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan. | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang maksimum: 500 Kondisi: | Bawaan— |
Kolommode | Jenisstring | PersyaratanWajib | Nilai & batasan std, pro Kondisi: | Bawaan— |
Kolommodel_name | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Penggantian nilai bawaan model bersifat opsional. Jangan sertakan untuk menggunakan model yang dipilih secara otomatis; nilai yang ditetapkan secara eksplisit tetap dipertahankan. | Bawaan— |
Kolomcfg_scale | Jenisnumber | PersyaratanOpsional | Nilai & batasan Minimum: 0 Maksimum: 1 Kondisi: | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: | Bawaan— |
Kolomnegative_prompt | Jenisstring | PersyaratanOpsional | Nilai & batasan Panjang maksimum: 200 Kondisi: | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanOpsional | Nilai & batasan 5, 10 Kondisi: | Bawaan— |
Parameter metode dan siklus hidup
| 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 perutean Ailoot ini persis seperti yang ditampilkan., Penggantian nilai bawaan model bersifat opsional. Jangan sertakan untuk menggunakan model yang dipilih secara otomatis; nilai yang ditetapkan secara eksplisit tetap dipertahankan. |
Alias metode: /v1/videos/generations
Siklus hidup: 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}
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $6 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
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 berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan header secara utuh, pengenal asli, setiap keluaran aktual, dan semua bidang penggunaan/akuntansi. Simpan setiap aset unik milik Ailoot dan pertahankan setiap peran yang menunjuk kepadanya.
Jika respons asli perlu diperiksa
Simpan id tugas atau operasi publik yang dikembalikan beserta semua header. Baca hanya tugas awal; unknown atau result_pending_check tidak mengizinkan pembuatan lain.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolompolling_url | Jenisstring |
Kolomprovider_task_id | Jenisstring |
Kolomdata.task_id | Jenisstring |
Kolomdata.task_status | Jenisstring |
Kolomdata.task_result.videos[].url | Jenisstring |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiKolom wajib, pemilih model, tipe, atau bentuk masukan tidak valid. | Langkah berikutnyaPeriksa rincian validasi yang dikembalikan sebelum menyiapkan permintaan terpisah. |
Respons | KondisiPermintaan atau hasil asli tidak diketahui atau perlu diperiksa. | Langkah berikutnyaSimpan pengenal dan header asli; baca hanya catatan status/pustaka yang didukung. Jangan kirim ulang permintaan pembuatan. |
Alias
Alias model
Ailoot Ultra kling-v2-1-master
Alias jalur metode
/v1/videos/generations
ID pemanggil terkait
FAQ · Kling v2.1 Master
- Input dan hasil apa yang tersedia?
POST /v1/videos·kling-v2-1-master:text→video- Kolom apa yang digunakan permintaan?
POST /v1/videos·kling-v2-1-master:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Batasan apa yang berlaku?
POST /v1/videos·kling-v2-1-master:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200