Інструкція з інтеграції 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://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.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://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.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"
}

​

Висновок