Kling v1.5
Kling v1.5 — құжаттамасында суреттен видео жасау үдерісі сипатталған видео моделі. Дайын статикалық суреттен бастап, кейіпкерге, затқа немесе ортаға арналған қысқа кадрдың қозғалысын, көру нүктесін және соңғы композициясын сипаттаңыз.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Kling v1.5 — құжатталған модельдер каталогында суреттен видео жасау мүмкіндігі бар Kling видео генерациялау нұсқасы. Берілген статикалық сурет визуалдық бастапқы нүктені белгілейді, ал жазбаша тапсырма көріністің қалай қозғалуы керегін сипаттайды. Оны композициясы кадрға сай келетін суреттен кейіпкердің қимылын, қозғалатын затты немесе өзгеретін ортаны дамыту үшін қолданыңыз.
Суретті нысанның маңызды белгілеріне қарай дайындаңыз. Кейіпкердің беті, дене қалпы және киімі анық көрінуі керек; заттың сұлбасы мен материал ерекшеліктері айқын болуы қажет. Композицияда көзделген қозғалысқа орын қалдырыңыз. Сыртқы көріністегі өзгерістерді тікелей бағалау үшін бастапқы статикалық суретті дайын тізбекпен бірге сақтаңыз.
Әрекетті көзге көрінетін оқиға ретінде жазыңыз. Мысалы, отырған адамның терезеге қарай бұрылуын немесе жеңіл самалмен тербелген мата таспаны сипаттаңыз. Бағытын және көзделген аяқталуын көрсетіңіз. Бірнеше зат көрінсе, қайсысы әрекет ететінін және қайсысы орнында қалатынын анықтаңыз.
Камераның рөлін түсіндіріңіз. Қозғалмайтын көру нүктесі шағын қимылды мұқият қарауға ыңғайлы болуы мүмкін, ал қозғалатын көру нүктесі көріністің жаңа қырын аша алады. Бұл қозғалысты нысанмен байланысы арқылы сипаттаңыз. Камераның нысанға жақындауын сұрау мен нысанның камераға жақындауын сұрау әртүрлі визуалдық мақсатты білдіреді.
Құжаттамадағы суреттен видео жасау жазбасында бес және он секундтық ұзақтық нұсқалары, std және pro режимдері, сондай-ақ көлденең, тік және шаршы кадр пішімдері көрсетілген. Нәтижені бағаламас бұрын таңдалған үдерісте ұсынылатын баптауларды таңдаңыз. Кадр нұсқаларын салыстырғанда нақты режимді, ұзақтықты және кадр пішімін бастапқы суретпен және сұраумен бірге сақтаңыз.
Затты таныстыру үшін қозғалыс арқылы ашылуы тиіс визуалдық ерекшелікті анықтаңыз. Ол шағылыстыратын бет, материалдың қатпары немесе тұтқаның пішіні болуы мүмкін. Маңызды ерекшелік көрініп тұратындай әрекетті бір мақсатқа шоғырландырыңыз. Затты бүкіл қозғалыс бойында және монтажда қолданылатын соңғы көріністе бағалаңыз.
Кейіпкер қатысатын көріністе мәнді бір қимылды және кейіпкердің маңындағы заттармен байланысын сипаттаңыз. Уақыт өте бет, қол, киім және дене пропорцияларының өзгеруін қарап шығыңыз. Қимылдың көзделген нәтижесіне жететінін және алдыңғы әрі артқы пландағы элементтердің қисынды орналасуын сақтайтынын тексеріңіз.
Жасалған үзіндіні толық күйінде және оның бастапқы материалдарымен бірге сақтаңыз. Басталуын, негізгі әрекетін және аяқталуын біртұтас тізбек ретінде қарап, кейін нақты сәйкессіздікке қарай түзетіңіз. «Кейіпкер терезеден кері бұрылады» деген сияқты ескерту келесі тапсырмаға нақты түзету береді әрі көріністің қалған бөлігін сақтауға мүмкіндік береді.
Ailoot Ultra · Video POST /v1/videos kling-v1-5
kling-v1-5Бастау
Kling v1.5 — құжаттамасында суреттен видео жасау үдерісі сипатталған видео моделі. Дайын статикалық суреттен бастап, кейіпкерге, затқа немесе ортаға арналған қысқа кадрдың қозғалысын, көру нүктесін және соңғы композициясын сипаттаңыз.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Video POST /v1/videos
- Кіріс
text,image- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер kling-v1-5 Шарттар: Ailoot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз. | Әдепкі— |
Өрісmode | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер std, pro Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкіstd |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 16:9, 9:16, 1:1 Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 5, 10 Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісend_image | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісimage | Түріstring or array<string> | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Кескініңіздің нақты қолжетімді URL мекенжайын беріңіз. Тізім параметр схемасында массив көрсетілген жағдайда ғана қабылданады. | Әдепкі— |
Өрісnegative_prompt | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, image |
Параметрoptional | Параметр талаптарыmode, aspect_ratio, duration, end_image, negative_prompt |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрconditions | Параметр талаптарыAiloot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Кескініңіздің нақты қолжетімді URL мекенжайын беріңіз. Тізім параметр схемасында массив көрсетілген жағдайда ғана қабылданады., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. |
Әдістің балама атаулары: /v1/videos/generations
Өмірлік цикл: 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}
Тарифтер
Қорытынды төлем қалай есептеледі
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Салыстыруға арналған болжамды мөлшерлемелер
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $6 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
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
Нәтижелерді алу және сақтау
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}
Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Толық жауап пен тақырыптарды, бастапқы идентификаторларды, әрбір нақты шығыс нәтижесін және пайдалану мен есепке алудың барлық өрістерін сақтаңыз. Иелігіңіздегі әрбір бірегей ресурсты сақтап, оған сілтейтін барлық рөлді сақтаңыз.
Бастапқы жауапты тексеру қажет болса
Қайтарылған ашық тапсырма не операция id мәнін және барлық тақырыптарды сақтаңыз. Тек бастапқы тапсырманы оқыңыз; unknown немесе result_pending_check күйі қайта жасауға рұқсат бермейді.
Жауап өрістері
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісpolling_url | Түріstring |
Өрісprovider_task_id | Түріstring |
Өрісtask_id | Түріstring |
Өрісstatus | Түріstring |
Өрісvideo_url | Түріstring |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өріс, модель селекторы, түр немесе кіріс деректерінің ұсынылу пішімі жарамсыз. | Келесі қадамБөлек сұрауды дайындамас бұрын қайтарылған тексеру мәліметтерін қарап шығыңыз. |
Жауап | ШартБастапқы сұрау немесе нәтиже белгісіз не тексеруді қажет етеді. | Келесі қадамБастапқы идентификаторлар мен тақырыптарды сақтаңыз; тек қолдау көрсетілетін күй немесе кітапхана жазбаларын оқыңыз. Жасау сұрауын қайта жібермеңіз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra kling-v1-5
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · Kling v1.5
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·kling-v1-5:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·kling-v1-5:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt