Kling v2 Master
Kling v2 Master мәтіннен немесе суретке негізделген тапсырмадан қысқа видео көріністер жасайды. Құжаттамадағы модель жазбасында айқын әрекет пен аяқталу төңірегінде кадр құруға арналған бес және он секундтық ұзақтық нұсқалары және бірнеше кадр пішімі көрсетілген.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Kling v2 Master — құжатталған каталогта мәтіннен және суреттен видео жасау мүмкіндігі бар Kling видео моделі. Жаңа көрініс дамыту үшін жазбаша тапсырманы қолданыңыз немесе оның келбетін белгілейтін суреттен бастаңыз. Әр кадрға орынды таныстыру, өзара әрекетті көрсету немесе заттың бір бөлшегін ашып көрсету сияқты нақты мақсат беріңіз.
Жаңа көрініс үшін негізгі нысанды, айналасын және көрермен бақылауы тиіс қозғалысты сипаттаңыз. Маңызды физикалық байланыстарды қосыңыз: үстелдегі зат, есік ойығының жанындағы адам немесе бұрылысқа жақындаған көлік. Бұл егжей-тегжейлер дайын видеода көзделген оқиғаны бағалауды жеңілдетеді.
Суретке негізделген кадр үшін қажетті нысан мен кадр құрылымы бар үлгіні дайындаңыз. Айрықша жиектер, бет белгілері және материалдар анық көрінсін. Сол көріністен ненің қозғалатынын және соңғы композицияда не болуы керегін сипаттаңыз. Нысанның бүкіл тізбек бойында бірізді қалатынын тексергенде бастапқы суретті қолданыңыз.
Құжаттамадағы модель жазбасында бес және он секундтық ұзақтықтар көрсетілген. Әрекеттің басталуы, дамуы және аяқталуы таңдалған кадр ұзақтығына сыятындай жоспарлаңыз. Қысқа қимыл мен камера арқылы ашып көрсетудің ырғақ талаптары әртүрлі. Нақты үзіндінің аяқталуы жоспарланған монтажға жарайтынын тексеріңіз.
Құжатталған модель басқару элементтеріне std және pro режимдері, сондай-ақ көлденең, тік және шаршы кадр пішімдері кіреді. Үдеріске ұсынылған опцияларды таңдап, олардың мәндерін нәтижемен бірге сақтаңыз. Маңызды нысанды қолданылатын пішімге сай кадрлаңыз, сонда оның шешуші әрекеті қозғалыс кезінде де көрініп тұрады.
Камера қозғалысын нысанмен байланысы арқылы сипаттаңыз. Заттың жанынан өтетін камера мен қозғалмайтын камераның алдында бұрылатын зат әртүрлі ақпаратты ашады. Көзделген қозғалысты анық көрсетіп, оны аудитория байқауы тиіс визуалдық ерекшелікпен немесе оқиғаның маңызды сәтімен байланыстырыңыз.
Толық тізбектің сабақтастығын, өзара әрекеттерін және уақыттық құрылымын тексеріңіз. Нысанның пішінін, маңындағы беттермен жанасуын және көрініс ішіндегі орнын бақылаңыз. Кейіпкер үшін әрекет бойындағы бетін, қолдарын және киімін тексеріңіз. Зат үшін көру бұрышы өзгергенде оның сұлбасы мен материал келбетін тексеріңіз.
Дайын видеоны, сұрауды, үлгіні және баптауларды бір кадр жазбасы ретінде сақтаңыз. Нұсқаларды бірдей көру жағдайында және бір визуалдық мақсатпен салыстырыңыз. Түзеткенде байқалған сәйкессіздікті анықтап, көріністің пайдалы бөліктерін сақтаңыз да, сол нақты мәселені шешетін нұсқауды өзгертіңіз.
Ailoot Ultra · Video POST /v1/videos kling-v2-master
kling-v2-masterБастау
Kling v2 Master мәтіннен немесе суретке негізделген тапсырмадан қысқа видео көріністер жасайды. Құжаттамадағы модель жазбасында айқын әрекет пен аяқталу төңірегінде кадр құруға арналған бес және он секундтық ұзақтық нұсқалары және бірнеше кадр пішімі көрсетілген.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Video POST /v1/videos
- Кіріс
text,image- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер kling-v2-master Шарттар: 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> | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісnegative_prompt | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional | Параметр талаптарыmode, aspect_ratio, duration, end_image, image, negative_prompt |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрconditions | Параметр талаптарыAiloot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. |
Әдістің балама атаулары: /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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v2-master", "prompt": "A cat is walking on grass."}')
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-v2-master
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · Kling v2 Master
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·kling-v2-master:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·kling-v2-master:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt