Инструкция по интеграции API Kling Motion Generation

​

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

📘 Полная документация: 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"
}

​

Заключение