Інструкція з інтеграції Kling Motion Generation API

​

Процес подання заявки

📘 Повна документація: Kling Motion Generation API →

​

Базове використання

• accept: у якому форматі ви хочете отримати результат відповіді; тут вказано application/json, тобто формат JSON.
• authorization: ключ для виклику API, після отримання його можна безпосередньо вибрати зі спадного списку.

• image_url: URL еталонного зображення зовнішності персонажа. Підтримуються JPG/JPEG/PNG, файл ≤50MB, ширина й висота обидві ≥300px, співвідношення сторін 1:2.5～2.5:1; персонаж має чітко показувати верхню частину тіла або все тіло та голову.
• video_url: URL еталонного відео рухів. Підтримуються MP4/MOV, файл ≤100MB, ширина й висота кожна 340–3850px, щонайменше 3 секунди; за character_orientation=image максимальна тривалість 10 секунд, за character_orientation=video — максимальна тривалість 30 секунд. Рекомендується використовувати безперервне однокадрове відео, у якому персонаж завжди перебуває в кадрі.
• mode: режим генерування відео, переважно є два види: стандартний режим std і надшвидкий режим pro.
• keep_original_sound: можна вибрати, чи зберігати оригінальний звук відео, значення переліку: yes, no.
• character_orientation: орієнтація персонажа в згенерованому відео; можна вибрати відповідність зображенню або відео, значення переліку: image, video.
• prompt: промпт.
• callback_url: URL, на який потрібно надіслати результат зворотного виклику.
• async: необов’язково; коли встановлено true, інтерфейс негайно повертає task_id, без потреби вказувати callback_url, після чого результат отримується шляхом опитування через відповідний інтерфейс запиту завдання.

{
  "success": true,
  "video_id": "842578800134742051",
  "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
  "duration": "5.066",
  "state": "succeed",
  "task_id": "363c7a84-e880-472e-a4d4-098e50cfc292"
}

• success — статус завдання генерування відео в цей момент.
• task_id — ID завдання генерування відео в цей момент.
• video_id — ID відео завдання генерування відео в цей момент.
• video_url — посилання на відео завдання генерування відео в цей момент.
• duration — тривалість відео завдання генерування відео в цей момент.
• state — стан завдання генерування відео в цей момент.

curl -X POST 'https://api.acedata.cloud/kling/motion' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
  "video_url": "https://cdn.acedata.cloud/odwfm5.mp4",
  "prompt": "让画面生动起来",
  "mode": "std",
  "character_orientation": "image"
}'

​

Асинхронний зворотний виклик

{
  "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}

{
    "success": true,
    "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
    "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
    "duration": "5.1",
    "state": "succeed",
    "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}

​

Обробка помилок

• 400 token_mismatched：Неправильний запит, можливо, через відсутні або недійсні параметри.
• 400 api_not_implemented：Неправильний запит, можливо, через відсутні або недійсні параметри.
• 401 invalid_token：Неавторизовано, недійсний або відсутній токен авторизації.
• 429 too_many_requests：Занадто багато запитів, ви перевищили обмеження швидкості.
• 500 api_error：Внутрішня помилка сервера, щось пішло не так на сервері.

​

Приклад відповіді з помилкою

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Висновок