kling-v1
kling-v1 aniq std yoki pro rejimi bilan matnli promptdan video yaratadi. Kadr davomiyligi va prompt sozlamalarini belgilang, keyin Ailoot orqali tugallangan barcha video natijalarni oling.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
/v1/videos da kling-v1 ni model, prompt va mode bilan ishlating. std yoki pro ni tanlang va kadrni ko‘pi bilan 500 belgili promptda tasvirlang. So‘rov besh yoki o‘n soniyalik duration, aspect_ratio, model_name, cfg_scale va ko‘pi bilan 200 belgili negative_prompt ni taklif etadi.
Promptdagi mavjud joyni asosiy mavzu, bitta harakat, muhit va kamera ko‘rsatmasi uchun ishlating. Bezakli iboralardan oldin kompozitsiyani belgilaydigan tafsilotlarni yozing. cfg_scale boshqaruvi 0 dan 1 gacha qiymatlarni qabul qiladi; keyingi variantni taqqoslashda tanlangan sozlamani topshiriq bilan saqlang.
Jarayonni tekshirish uchun ikkinchi operatsiya yaratish o‘rniga asl so‘rov ID sini kuzating. Natija data.task_status va data.task_result.videos[].url dan foydalanadi, succeed tugallanishni bildiradi. Tugallangan har bir videoni va uning to‘liq javobini saqlang, keyin butun kadrni promptga solishtiring.
Ailoot Ultra · Video POST /v1/videos kling-v1
kling-v1Boshlash
kling-v1 aniq std yoki pro rejimi bilan matnli promptdan video yaratadi. Kadr davomiyligi va prompt sozlamalarini belgilang, keyin Ailoot orqali tugallangan barcha video natijalarni oling.
- Qabul qilinadigan kirish ma’lumotlari
- Matn
- Natijalar
- Video
Ailoot da mavjud · kirish ma’lumotlari va usullar
Ailoot Ultra · Video POST /v1/videos
- Kirish
text- Chiqish
video
| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar kling-v1 Shartlar: Ailoot soʻrovlarini yoʻnaltirish uchun aynan shu selektordan foydalaning. | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng ko‘p uzunlik: 500 Shartlar: | Standart— |
Maydonmode | Turstring | TalabMajburiy | Qiymatlar va cheklovlar std, pro Shartlar: | Standart— |
Maydonmodel_name | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Modelning asl sozlamasini oʻzgartirish ixtiyoriy. Tanlangan modeldan avtomatik foydalanish uchun uni yubormang; aniq berilgan qiymat saqlanadi. | Standart— |
Maydoncfg_scale | Turnumber | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 0 Eng ko‘p: 1 Shartlar: | Standart— |
Maydonaspect_ratio | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: | Standart— |
Maydonnegative_prompt | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng ko‘p uzunlik: 200 Shartlar: | Standart— |
Maydonduration | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar 5, 10 Shartlar: | Standart— |
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, prompt, mode |
Parametroptional | Parametr talablarimodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametrmaterial_types | Parametr talablaritext |
Parametrconditions | Parametr talablariAiloot soʻrovlarini yoʻnaltirish uchun aynan shu selektordan foydalaning., Modelning asl sozlamasini oʻzgartirish ixtiyoriy. Tanlangan modeldan avtomatik foydalanish uchun uni yubormang; aniq berilgan qiymat saqlanadi. |
Usul taxalluslari: /v1/videos/generations
Hayot sikli: 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}
Tariflar
Yakuniy to‘lov qanday hisoblanadi
Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
- Tezkor rejim
- Ko‘rsatilmagan Tezkor rejim tanlanganda
- Flex rejimi
- Ko‘rsatilmagan flex rejimi tanlanganda
- Maksimal fikrlash darajasi
- Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda
Taqqoslash uchun taxminiy tariflar
Sozlamalar bo‘yicha narxlar
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Prognoz miqdori | To‘lov |
|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $6 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas. |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
So‘rov namunalari
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", "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
Natijalarni olish va saqlash
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}
Barcha tayyor natijalarni saqlash
Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.
To‘liq javob va sarlavhalarni, dastlabki identifikatorlarni, har bir haqiqiy chiqishni va barcha foydalanish/hisob-kitob maydonlarini saqlang. Egalik qilinadigan har bir noyob aktivni saqlang va unga ishora qiluvchi har bir vazifani saqlab qoling.
Asl javobni tekshirish kerak bo‘lsa
Qaytarilgan ochiq vazifa yoki operatsiya id sini va barcha sarlavhalarni saqlang. Faqat dastlabki vazifani o‘qing; unknown yoki result_pending_check boshqa yaratish so‘roviga ruxsat bermaydi.
Javob maydonlari
| Maydon | Tur |
|---|---|
Maydonid | Turstring |
Maydonpolling_url | Turstring |
Maydonprovider_task_id | Turstring |
Maydondata.task_id | Turstring |
Maydondata.task_status | Turstring |
Maydondata.task_result.videos[].url | Turstring |
Xatolar va keyingi qadamlar
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob400 · invalid_request_error | ShartMajburiy maydon, model selektori, tur yoki kirish maʼlumotining ifodalanishi notoʻgʻri. | Keyingi qadamAlohida soʻrov tayyorlashdan oldin javobda qaytarilgan tekshiruv tafsilotlarini koʻrib chiqing. |
Javob | ShartAsl soʻrov yoki natija nomaʼlum yoki tekshirishni talab qiladi. | Keyingi qadamAsl identifikatorlar va sarlavhalarni saqlang; faqat qoʻllab-quvvatlanadigan holat/kutubxona yozuvlarini oʻqing. Yaratish soʻrovini qayta yubormang. |
Taxalluslar
Model taxalluslari
Ailoot Ultra kling-v1
Usul yo‘llari taxalluslari
/v1/videos/generations
Chaqirish uchun tegishli ID lar
FAQ · kling-v1
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/videos·kling-v1:text→video- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/videos·kling-v1:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Qanday cheklovlar amal qiladi?
POST /v1/videos·kling-v1:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200