Kling-те тікелей онбордингтен өтпей Kling API-ін қалай пайдалану керек: 2026 жылға арналған нұсқаулық

Қысқаша Сіз Kling-тің қолдау көрсетілетін видео модельдеріне CometAPI арқылы CometAPI аккаунты мен API кілтін пайдаланып қол жеткізе аласыз; бөлек Kling әзірлеуші онбордингін аяқтаудың қажеті жоқ. Ағымдағы мәтіннен видеоға маршрут — POST /kling/v1/videos/text2video. Ол тапсырма идентификаторын қайтарады, оны сіздің бэкенд тапсырма succeed немесе failed күйіне жеткенше сұраумен бақылайды. Модельдің қолжетімділігі, параметрлері, бағасы және аккаунтқа қойылатын талаптар өзгеруі мүмкін, сондықтан өндірістік енгізуге дейін әрекеттегі модель каталогын және API құжаттамасын тексеріңіз.

Тікелей жауап

Прагматикалық жол — CometAPI-дегі Kling модель каталогы. Қажетті Kling моделі сіздің CometAPI аккаунтыңызда қолжетімді болса, серверіңіз CometAPI API кілтімен аутентификация жасап, сәйкес Kling-үйлесімді endpoint-ке қоңырау шала алады. Бұл жол үшін бөлек Kling API өтінімі интеграция қадамдарының құрамына кірмейді.

Бұл айырмашылық басқа модельдер үшін CometAPI-ді қазірдің өзінде пайдаланатын топтар үшін маңызды. Қосымша Kling бейне жұмыс процесін қосқанда да бір ғана тіркелгі деректерін басқару беті мен бір провайдерлік қатынасты сақтайды. Дегенмен, кодыңыз Kling-тің видеоға тән сұрау схемасын және асинхронды тапсырма өмірлік циклін қолдануы керек; “бір API кілті” барлық провайдерлер бірдей сұрау денесін қолданады дегенді білдірмейді.

Бұл мақала мәтіннен видеоға бағытталады, себебі бұл — ең шағын әрі пайдалы интеграция. CometAPI сонымен қатар суреттен видеоға және басқа Kling жұмыс процестерін құжаттайды, бірақ әрқайсысының өз endpoint-і мен параметр шектеулері бар. Алдымен бір расталған жолдан бастаңыз, кейін тек ағымдағы құжаттаманы тексергеннен кейін ғана мүмкіндіктерді қосыңыз.

Бұл жолдың әзірлеуші команда үшін пайдалы болуының себептері

Тікелей пайда — операциялық, сиқыр емес. CometAPI-ді қазірдің өзінде пайдаланатын команда тағы бір тікелей провайдер интеграциясын жасамай-ақ, қосымша тіркелгі деректерін таратпай-ақ немесе бөлек аккаунтты басқару жолын құрмай-ақ қолжетімді Kling жұмыс процесін қоса алады. Бұл сіздің платформаңызға ұсталатын құпиялар санын, есеп айырысу қатынастарын және провайдерге тән клиенттік конфигурацияларды азайта алады.

Екінші пайда — архитектуралық. Қолданба шағын ішкі видео генерациялау келісімін — prompt, жұмыс процесі, модель, опциялар және жұмыс күйі — ұсына алады, ал провайдер адаптері осы келісімді құжатталған Kling сұрауына аударады. Кейін команда басқа видео моделін бағаласа да, endpoint жолдары, параметрлер мен шығыс метадеректері өзгеше болғанымен, өнімге бағытталған жұмыс моделі тұрақты қала алады.

Шектеу де сондай маңызды: біріктірілген қолжетім қабаты астындағы модельдерді алмастырмалы етпейді. Prompt мінез-құлқы, қабылданатын медиа, кідіріс, баға, қауіпсіздік саясаты және нәтижелер схемалары әртүрлі болуы мүмкін. Бұл айырмашылықтарды қолдауы жоқ болжамдардың артына жасырудың орнына конфигурацияда және тесттерде айқын ұстаңыз.

Бұл қолжетім жолы не өзгертеді — және не өзгертпейді

Не өзгереді. Сіз CometAPI кілтін жасайсыз және басқарасыз, CometAPI-дің Kling-үйлесімді API-іне сұраулар жібересіз және пайдалануды CometAPI жағынан бақылайсыз. Бұл нақты қолжетім жолынан бөлек тікелей Kling онбординг қадамын алып тастайды.

Не өзгермейді. Түпкі негіздегі модельдер отбасы ретінде Kling қалады. Провайдерге тән параметрлер, генерациялау мінез-құлқы, қолданыс ережелері, модель қолжетімділігі мен шығыс сипаттамалары әлі де маңызды. CometAPI құжаттамасы сондай-ақ провайдердің сұрау және жауап өрістері әртүрлі болуы мүмкін екенін атап өтеді, сондықтан әрекеттегі endpoint анықтамасын өзіңіздің имплементацияңыз үшін келісім ретінде қарастырыңыз.

Қолданбас бұрын нені тексеру керек. Аккаунтыңыз қажетті модель ID-іне қол жеткізе алатынын растаңыз, ағымдағы баға мен жылдамдық шектеулерін қарап шығыңыз және шағын аутентификацияланған тест жүргізіңіз. Өндірістік жұмыс процесін ескі блог жазбасынан немесе кэштелген мысалдан табылған модель атауына сүйеніп құрмаңыз.

Бастамас бұрын

Сізге CometAPI аккаунты, серверіңізде сақталатын API кілті және асинхронды тапсырманы орындай алатын бэкенд қажет. Кілтті COMETAPI_KEY сияқты орта айнымалысында сақтаңыз; оны браузерде немесе мобильді клиент кодында ашпаңыз.

1. Kling модель каталогын ашып, пайдаланбақшы болған моделіңіз аккаунтыңыз үшін қазір көрсетілгенін растаңыз.
2. Ағымдағы Kling мәтіннен видеоға арналған API анықтамасын қарап шығыңыз. Растау сәтінде құжатталған мысал kling-v3 қолданады.
3. CometAPI консолінде серверлік API кілтін жасаңыз және оны орындалу ортаңызға орнатыңыз.
4. Қызметіңіз тапсырма ID-ін және соңғы видеоны қайда сақтайтынын шешіңіз. Генерациялау сұрауы аяқталған видео файлды емес, тапсырманы қайтарады.

Сұрауды жобаламас бұрын Kling жұмыс процесін таңдаңыз

Өніміңізде бар активтен бастаңыз. Егер пайдаланушыда тек жазбаша тұжырымдама болса, мәтіннен видеоға — тікелей жол. Егер пайдаланушыда визуалды негіз ретінде сақталуы тиіс статикалық сурет болса, бөлек құжатталған суреттен видеоға маршрутын пайдаланыңыз. Мәтіннен видеоға арналған сұрауға сурет өрісін қосып, API жұмыс процесін өзі шығарады деп болжамаңыз.

Ағымдағы суреттен видеоға арналған анықтама жалпыға қолжетімді сурет URL-ін немесе base64 сурет жолын қабылдайды және асинхронды тапсырманы қайтарады. Неғұрлым маманданған Kling жұмыс процестерінің өз беттері мен сұрау шектеулері бар. Өнім талаптары мен ағымдағы құжаттама қосымша адаптерді негіздеген кезде ғана оларды біртіндеп қосыңыз.

Алғашқы өндірістік дәлел ретінде бір жұмыс процесін, бір расталған модель ID-ін, қысқа ұзақтықты және өкілдік prompt-тардың шағын жиынтығын қолданыңыз. Бұл аккаунтқа қолжетім мен тапсырма оркестрациясын субъективті нәтижені бағалаудан оқшаулайды. Құбыр сенімді болған соң, бір тестте бірнеше айнымалыны өзгертудің орнына, тұрақты бағалау жиынтығымен режимдер немесе модельдерді салыстырыңыз.

Алғашқы Kling мәтіннен видеоға сұрауыңызды жасаңыз

Ағымдағы мәтіннен видеоға арналған endpoint JSON және Bearer аутентификациясын қабылдайды. Қысқа prompt және ең аз қолдау көрсетілетін ұзақтықтан бастаңыз. Төмендегі сұрау ағымдағы CometAPI анықтамасында көрсетілген өрістерді ғана пайдаланады:

curl https://api.cometapi.com/kling/v1/videos/text2video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
    "model_name": "kling-v3",
    "mode": "std",
    "duration": "5",
    "sound": "off"
  }'

Сәтті жіберу data.task_id және тапсырма күйі бар объекті қайтарылады. Бұл тапсырма ID-ін қолданбаңыздың жұмыс жазбасымен бірге сақтаңыз. Видео жасалып жатқанда HTTP қосылымын ашық күйде ұстамаңыз.

Асинхронды тапсырманы қауіпсіз өңдеу

Kling генерациясы асинхронды. Мәтіннен видеоға үшін GET /kling/v1/videos/text2video/{task_id} арқылы периодты сұраңыз. CometAPI-дің тапсырма анықтамасында жауап тапсырманы тікелей немесе data қабықшасының ішінде қайтара алатыны айтылған, сондықтан мысал екі пішінді де қалыптандырады. Ол сондай-ақ барлық терминалдық емес күйлерді “күте тұру” ретінде қарастырады, аралық күйлердің тұрақты тізімі бар деп болжамайды.

import os
import time
import requests

API_KEY = os.environ["COMETAPI_KEY"]
BASE_URL = "https://api.cometapi.com/kling/v1/videos/text2video"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}


def submit_video(prompt: str) -> str:
    response = requests.post(
        BASE_URL,
        headers=HEADERS,
        json={
            "prompt": prompt,
            "model_name": "kling-v3",
            "mode": "std",
            "duration": "5",
            "sound": "off",
        },
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()
    return payload["data"]["task_id"]


def wait_for_video(task_id: str, timeout_seconds: int = 600) -> str:
    deadline = time.monotonic() + timeout_seconds
    poll_url = f"{BASE_URL}/{task_id}"

    while time.monotonic() < deadline:
        response = requests.get(poll_url, headers=HEADERS, timeout=30)
        response.raise_for_status()
        payload = response.json()
        task = payload.get("data") or payload
        status = task.get("task_status")

        if status == "succeed":
            videos = task.get("task_result", {}).get("videos", [])
            if not videos or not videos[0].get("url"):
                raise RuntimeError("Task succeeded without a video URL")
            return videos[0]["url"]

        if status == "failed":
            detail = task.get("task_status_msg") or task.get("task_result")
            raise RuntimeError(f"Kling task failed: {detail}")

        time.sleep(10)

    raise TimeoutError(f"Kling task {task_id} exceeded {timeout_seconds}s")


task_id = submit_video(
    "A small ceramic cup on a wooden table, steam rising in soft morning light"
)
video_url = wait_for_video(task_id)
print(video_url)

Терминалдық сәттілік жолы — succeed, succeeded емес. Тапсырма аяқталғанда, егер өніміңізде сақтау талап етілсе, генерацияланған активті өзіңіз бақылайтын қоймаға көшіріңіз. Провайдердің жеткізу URL-дерін тұрақты қолданбалық сақтау ретінде қарастырмаңыз.

Үлкен жүктемелерде веб-сұраудың ішінде сұрауды қайталап жасаудан гөрі кезек немесе worker қолданыңыз. CometAPI Kling тапсырмалары үшін callback URL-дерін де құжаттайды. Вебхуктарды қолдансаңыз, callback оқиғаларын аутентификациялап, қайталанатындарын жойыңыз және жіберілмей қалғандарын өтеу үшін сұраумен тексеруді сақтаңыз.

Масштабтамас бұрын қолданбалық жұмыс өмірлік циклін жобалаңыз

Провайдер тапсырмасын өзіңіздің жұмыс жазбаңыздың бір бөлігі ретінде қарастырыңыз. Қолданбалық жұмыс ID-ін, жұмыс процесін, сұралған модельді, провайдер тапсырма ID-ін, сұрау URL-ін, ағымдағы күйді, жіберу уақыт таңбасын, соңғы сұрау уақытын және шығыс орналасуын сақтаңыз. Бұл қолдау және операциялық топтарға сәтсіз немесе баяу генерацияны шикі сұрау журналдарын ақтармай-ақ зерттеуге жеткілікті контекст береді.

Клиент жауап алмағаны үшін ғана жасау сұрауын қайта жібермеңіз. Провайдер тапсырманы әлдеқашан жасап қойған болуы мүмкін. Жіберер алдында жергілікті жұмысты сақтаңыз, қайтарылған тапсырма ID-ін дереу жазыңыз және жасауды қайталап көруді күйді сұраумен тексеруден бөліңіз. Ағымдағы мәтіннен видеоға анықтама қолданбаны қадағалау үшін external_task_id өрісін де құжаттайды; оны дедупликация механизмі ретінде сүйенбей тұрып, әрекеттегі мінез-құлқын растаңыз.

const TERMINAL = new Set(["succeed", "failed"]);

function normalizeKlingTask(payload) {
  const task = payload?.data ?? payload;
  if (!task?.task_id || !task?.task_status) {
    throw new Error("Kling response is missing task identity or status");
  }
  return task;
}

async function refreshVideoJob(job, apiKey) {
  const response = await fetch(job.queryUrl, {
    headers: { Authorization: `Bearer ${apiKey}` },
  });

  if (!response.ok) {
    throw new Error(`Task query failed with HTTP ${response.status}`);
  }

  const task = normalizeKlingTask(await response.json());
  const outputUrl = task.task_result?.videos?.[0]?.url ?? null;

  return {
    ...job,
    providerTaskId: task.task_id,
    providerStatus: task.task_status,
    terminal: TERMINAL.has(task.task_status),
    outputUrl,
    failureDetail: task.task_status_msg ?? null,
    checkedAt: new Date().toISOString(),
  };
}

Бұл мысал әдейі провайдердің мүмкін аралық барлық күйлерін өнімдік уәделерге аудармайды. Сіздің worker терминалдық емес тапсырмаларды белсенді ұстайды, succeed және failed күйлерін айқын өңдейді және қателерді іздеу үшін провайдердің бастапқы күйін жазып алады. Тоқтап қалған тапсырма мәңгі ашық қалмауы үшін бөлек қолданбалық тайм-аут қосыңыз.

Негіз ретінде сұраумен тексеруді қолданыңыз, өйткені тапсырма ID-і сұрауға қолжетімді күйде қалады. Таңдалған endpoint callback_url қолдаса, вебхук қайталанатын күй сұрауларын азайта алады, бірақ ол сіздің жалғыз қалпына келтіру механизміңізге айналмауы тиіс. Ресми сұраумен тексеру және вебхук нұсқаулығы callback жүктемелерінің провайдерге тән болуы мүмкін екенін ескертеді. Бастапқы оқиғаны сақтаңыз, өңдеуді тапсырма ID-і бойынша идемпотент етіңіз, сәтті HTTP жауапты тез қайтарыңыз және терминалдық күйді сұраумен тексеру арқылы келісіңіз.

Әзірлеуші командаларға арналған өндірістік тексеру тізімі

• Модельді орындалу кезінде растаңыз. Ағымдағы каталогты тексеріңіз және сұралған модель қолжетімсіз болса, айқын қате қайтарыңыз. Нәтиже мінез-құлқы маңызды болса, басқа модельді үнсіз алмастырмаңыз.
• Жіберуді алу процесінен бөліңіз. Қайталанулар қосымша тапсырмалар туындатпау үшін CometAPI тапсырма ID-ін, өзіңіздің жұмыс ID-іңізді, таңдалған модельді және уақыт таңбаларын сақтаңыз.
• Сұраумен тексеруді шектеңіз. Тайм-аут, экспоненциалды backoff немесе орынды тұрақты интервал және максималды қайталап көру санын қолданыңыз. Параллелділікті арттырмас бұрын CometAPI-дің жылдамдық шектеуі мен параллелизм нұсқаулығын қарап шығыңыз.
• Қателерді жіктеңіз. Жарамсыз параметрлер немесе аутентификация сәтсіздіктерін қайта байқап көрмеңіз. Қайта байқап көруге болатын жылдамдық шектеуі және платформа қателеріне ағымдағы қайта әрекет ету нұсқаулығына сәйкес backoff қолданыңыз.
• Тіркелгі деректері мен енгізулерді қорғаңыз. API кілттерін сервер жағында ұстаңыз, құпияларды журналға жазудан аулақ болыңыз және пайдаланушылардың олар жіберетін кез келген prompt-тарға, суреттерге немесе басқа бастапқы активтерге құқықтары барын растаңыз.
• Жұмысты толық өлшеңіз. Жіберудің сәттілігін, кезекке тұру уақытын, генерация уақытын, терминалдық сәтсіздік деңгейін, тайм-аут деңгейін, нәтижені алу сәттілігін және құнын модель мен режим бойынша бақылаңыз.
• Шығыстарды саналы түрде сақтаңыз. Өніміңізге ұзақ мерзімді қолжетім қажет болғанда аяқталған активтерді өзіңіз бақылайтын қоймаға жүктеп алыңыз, содан кейін сақтау және жою саясатыңызды қолданыңыз.

Практикалық ЖҚС

Бұл жол үшін бөлек Kling әзірлеуші аккаунты қажет пе?

CometAPI интеграция ағынында бөлек Kling әзірлеуші онбординг қадамы жоқ. Сіз CometAPI аккаунты мен API кілтін қолданасыз. Қолжетім әлі де сіздің CometAPI аккаунтыңыз бен аймағыңыз үшін модельдің қолжетімділігіне тәуелді, сондықтан өндірісқа шығарар алдында мұны растаңыз.

Kling API толықтай OpenAI-пен үйлесімді ме?

Мұнда көрсетілген видео жұмыс процесі үшін — жоқ. Ол /kling/v1/videos/text2video сияқты Kling-ке тән маршруттарды және Kling-ке тән өрістерді қолданады. Тіркелгі деректерін CometAPI арқылы басқара аласыз, бірақ адаптеріңіз провайдерге тән схеманы сақтауы тиіс.

Қай Kling модель ID-ін қолдану керек?

Ағымдағы CometAPI мәтіннен видеоға анықтамасы алғашқы жұмыс істейтін мысалда kling-v3 қолданады және бұрынғы бірнеше модель тректерін тізімдейді. Әрекеттегі endpoint enum-ынан модель ID қолданыңыз және оның аккаунтыңызға қосылғанын растаңыз. Ең жаңа модель барлық жерде қолжетімді деп болжамаңыз.

Неліктен алғашқы жауап видеоны қамтымайды?

Видео генерациясы асинхронды тапсырма ретінде орындалады. Бастапқы жауап тапсырма ID-ін қайтарады. task_status succeed немесе failed болғанға дейін сәйкес сұрау маршрутын сұраумен тексеріңіз, содан соң нәтиже метадеректерін оқыңыз.

Сұраумен тексеруді қолданайын ба, әлде callback URL пайдаланайын ба?

Алғашқы интеграция үшін сұраумен тексеру оңай. Callback-тер ауқымды кезде қайталанатын сұрауларды азайтады, бірақ аутентификацияланған, идемпотент қабылдағыш пен қалпына келтіру логикасын қажет етеді. Көптеген өндірістік жүйелер callback-терді негізгі жол ретінде, ал сұраумен тексеруді резервтік ретінде қолданады.

Суреттен видеоға сол бір endpoint арқылы қолдана аламын ба?

Жоқ. CometAPI суреттен видеоға процесті бөлек маршрутпен, /kling/v1/videos/image2video арқылы құжаттайды. Мәтіннен видеоға мысалына сурет өрісін қосудың орнына, сол endpoint-тің ағымдағы сұрау схемасын ұстаныңыз.

Стандартты ма, әлде кәсіби режимнен бастайын ба?

Аутентификацияны, сұрау пішінін, тапсырма сақтауды, сұраумен тексеруді және нәтижені алуды растау үшін std қолданыңыз. Ағымдағы анықтама pro режимін жоғары сапалы әрі жоғары құнды деп сипаттайды. Негізгі жұмыс процесі жұмыс істегеннен кейін ғана оны өкілдік prompt-тармен бағалаңыз және нәтижелер сапасын генерация уақытымен және нақты құнымен бірге салыстырыңыз.

Қайталап көру кезінде қайталанған генерацияларды қалай болдырмауға болады?

API-ге қоңырау шалмас бұрын қолданбалық жұмыс жазбасын жасаңыз және қайтарылған провайдер тапсырма ID-ін бірден сақтаңыз. Күйді сұрауды жасаудан бөлек, тәуелсіз түрде қайта тексеріңіз. Бірдей POST-ты қайталау идемпотент деп болжамаңыз. Endpoint қазіргі уақытта қадағалау үшін external_task_id өрісін құжаттайды, бірақ оны дедупликация кепілі ретінде қабылдамас бұрын ағымдағы семантикасын растаңыз.

Қорытынды

Жеке тікелей Kling әзірлеуші өтінімін толықтырмай-ақ Kling видео генерациясын сынағысы келетін АҚШ-тағы әзірлеуші команда үшін CometAPI құжатталған жол ұсынады: аккаунт үшін қажетті Kling моделі қолжетімді екенін растаңыз, CometAPI кілтімен аутентификация жасаңыз, жұмыс процесіне тән endpoint-ке қоңырау шалыңыз және асинхронды тапсырманы терминалдық күйге дейін бақылаңыз.

Практикалық инженерлік құндылық — орталықтандырылған қолжетім мен қайта пайдаланылатын қолданбалық жұмыс моделі; барлық видео провайдерлер бірдей әрекет етеді деген болжам емес. Әр жұмыс процесіне жұқа адаптер ұстаңыз, тапсырма идентификациясын және шығуды саналы түрде сақтаңыз және callback қосулы болса да, қалпына келтіру жолы ретінде сұраумен тексеруді сақтаңыз.

Қауіпсіз шығарылым шағын әрі өлшенетін болуы тиіс: бір модель мен бір жұмыс процесін растаңыз, қысқа әрі арзан жұмыстарды жіберіңіз, терминалдық сәттілік пен сәтсіздік деңгейлерін жазып алыңыз, нәтижені алуды тексеріңіз және нақты құн мен кідірісті өнім талаптарымен салыстырыңыз. Ағымдағы құжаттама мен нысан аккаунт тексерілгеннен кейін ғана суреттен видеоға немесе қосымша Kling жұмыс процестеріне кеңейтіңіз.