models

official-kling-v1-effect

Markdown · JSON

official-kling-v1-effect

Kling V1 Effect сурет материалы мен әсер тапсырмасын видеоға айналдырады. Құжатталған effect_scene мәнін таңдап, дайын нәтиже үшін бастапқы Ailoot операциясын сақтаңыз.

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

official-kling-v1-effect моделін image және prompt өрістерімен пайдаланыңыз. effect_scene нұсқалары: hug, kiss немесе heart_gesture. image өрісі жолды немесе екі жолға дейінгі массивті қабылдайды; mode std не pro ұсынады, duration бес не он секундты береді, ал aspect_ratio көлденең, тік не шаршы кадрлауды таңдайды.

Таңдалған әрекетке нысандары мен арақашықтығы сай бастапқы материал дайындаңыз. Prompt ішінде қажетті қозғалыс пен соңғы композицияны сипаттап, камера нұсқауын әсер таңдауынан бөлек ұстаңыз. Дайын кадрдағы көзделген ым мен нысанның сыртқы түрін тексеру үшін әсердің дәл мәнін, суреттерді және тапсырманы сұраумен бірге сақтаңыз.

Кадрды /v1/videos арқылы бір рет жіберіңіз, қайтарылған сұрау ID-ін сақтап, /v1/videos/{request_id} арқылы сол бастапқы операцияның күйін сұраңыз. Әр дайын видео нәтижесін және толық жауапты сақтап, содан кейін әрекетті, кадрлауды және соңғы күйді тапсырмамен салыстырыңыз.

Ailoot Ultra · Video POST /v1/videos official-kling-v1-effect

official-kling-v1-effect

Басқа /official-kling-v1-effect

Бастау

Kling V1 Effect сурет материалы мен әсер тапсырмасын видеоға айналдырады. Құжатталған effect_scene мәнін таңдап, дайын нәтиже үшін бастапқы Ailoot операциясын сақтаңыз.

Қабылданатын кіріс деректері
Мәтін · Суреттер
Нәтижелер
Бейне

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Video POST /v1/videos
Кіріс
text, image
Шығыс
video
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
official-kling-v1-effect
Шарттар: Ailoot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз.
Әдепкі—
Өрісeffect_sceneТүріstringТалапМіндетті емесМәндер мен шектеулер
hug, kiss, heart_gesture
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкіstd
ӨрісmodeТүріstringТалапМіндетті емесМәндер мен шектеулер
std, pro
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкіstd
Өрісaspect_ratioТүріstringТалапМіндетті емесМәндер мен шектеулер
16:9, 9:16, 1:1
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
ӨрісdurationТүріintegerТалапМіндетті емесМәндер мен шектеулер
5, 10
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
ӨрісimageТүріstring or array<string>ТалапМіндеттіМәндер мен шектеулер
Шарттар: Кескініңіздің нақты қолжетімді URL мекенжайын беріңіз. Тізім параметр схемасында массив көрсетілген жағдайда ғана қабылданады.
Әдепкі—
Өрісnegative_promptТүріstringТалапМіндетті емесМәндер мен шектеулер
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
ӨрісpromptТүріstringТалапМіндеттіМәндер мен шектеулер
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
Әдіс параметрлері мен өмірлік циклі
ПараметрПараметр талаптары
Параметрcontent_typeПараметр талаптарыapplication/json
ПараметрrequiredПараметр талаптарыmodel, image, prompt
ПараметрoptionalПараметр талаптарыeffect_scene, mode, aspect_ratio, duration, 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 токен
БаптауГенерацияның болжамды құныМөлшерлемелер кестесі—Болжамды мөлшербір генерацияға арналған болжамТөлем
Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.3 жасауға дейінгі бағалау

Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Video

curl · бір рет құрып, нәтижені толық сақтаңызБастапқы тапсырманы оқыңызӨзіңізге тиесілі толық дайын болған әрбір ресурсты сақтаңыз
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": "official-kling-v1-effect", "image": "YOUR_ACCESSIBLE_IMAGE_URL", "prompt": "A cat is walking on grass."}')
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}/content
  • GET /v1/media/assets
  • GET /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 official-kling-v1-effect

Әдіс жолдарының балама атаулары

/v1/videos/generations

Шақыруға арналған байланысты ID

official-kling-v1-effect

FAQ · official-kling-v1-effect
Қандай кіріс деректері мен нәтижелер қолжетімді?

POST /v1/videos · official-kling-v1-effect: text, image → video

Сұрау қандай өрістерді пайдаланады?

POST /v1/videos · official-kling-v1-effect: model, effect_scene, mode, aspect_ratio, duration, image, negative_prompt, prompt

Толығырақ

Ailoot-ты Claude Code, OpenCode, Hermes не қолданбаңызға қосыңыз.

Компания және оның жобалар портфелі

Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.

Токенді жеңілдікпен сатып алыңыз.

Тұрақты жұмысқа жазылым жеңілдігі. Токен сатып алуға промокодтар — 50% дейін.

Жазылым
Тұрақты сұрауыңызға жеңілдікті тариф таңдаңыз.
50% дейінгі промокод
Сатып алғанда код енгізіңіз. Баға қазіргі науқанмен қайта есептеледі.
Тарихтағы шығындар
Әр сұрауға модель, токен және сома сақталады.

Жазылым таңдау · Модель бағасын көру

API-ді сататын өніміңізге қосыңыз.

SaaS, қолданба мен бот Ailoot офертасы және лицензиялық шартына сай. Қайта сатуға реселлер лицензиясын сұраңыз.

Коммерциялық қолданба
Қызметіңіздің ақылы функциясына мәтін, сурет, бейне және дыбыс жасауды қосыңыз.
Реселлер лицензиясы
Жоба сипаттамасы мен кіру схемасын жіберіңіз. Пайдалану мен қайта сатуға жазбаша шарт сұраңыз.
Сайттағы құжаттар
Оферта, лицензиялық шарт және дерек саясаты қоспай тұрып қолжетімді.

Реселлер лицензиясын сұрау · Оферта мен лицензиялық шарт