Kling Motion Generation API 对接说明
内容提要
本文介绍Kling Motion Generation API的对接方法。用户需在Ace Data Cloud控制台获取API Token，通过输入提示词、参考图片和视频URL生成视频。文章详细说明了请求参数（如mode、character_orientation、callback_url）、同步与异步回调流程、错误处理代码，并提供了CURL示例和返回结果字段解析，帮助开发者快速集成该API。
延伸解读
同步与异步模式的选择
文章指出，Kling Motion Generation API 生成视频耗时约1-2分钟，若使用同步请求，HTTP连接会长时间保持，消耗系统资源。因此，API提供了异步回调机制：请求时传入callback_url，接口立即返回task_id，任务完成后通过POST请求将结果发送至回调地址。开发者应根据实际场景选择同步或异步模式，异步模式更适合长时间任务，可避免连接超时和资源浪费。
输入参数的限制条件
调用API时需注意输入文件的严格限制：参考图片支持JPG/JPEG/PNG，大小不超过50MB，宽高均不小于300px，宽高比在1:2.5至2.5:1之间；参考视频支持MP4/MOV，大小不超过100MB，宽高在340-3850px之间，时长至少3秒，且根据character_orientation参数不同，最长时长分别为10秒或30秒。建议使用人物始终在画面内的连续单镜头视频，以确保生成效果。
错误码与排查建议
文章列出了常见错误码及其含义：400表示参数缺失或无效，401表示token无效或缺失，429表示请求频率超限，500表示服务器内部错误。错误响应中包含error.code和message字段，以及trace_id用于追踪问题。开发者应检查请求参数、token有效性、请求频率，并利用trace_id向技术支持反馈，以快速定位和解决问题。
Q&A
如何获取Kling Motion Generation API的API Token？
首先到Ace Data Cloud控制台获取API Token。如果尚未登录或注册，会自动跳转到登录页面，注册登录后会自动返回当前页面。一个API Token即可调用平台所有服务，首次申请会赠送免费额度。
Kling Motion Generation API支持哪些输入参数？
主要参数包括：image_url（人物外观参考图URL，支持JPG/JPEG/PNG，≤50MB，宽高≥300px，宽高比1:2.5~2.5:1）、video_url（动作参考视频URL，支持MP4/MOV，≤100MB，宽高340-3850px，至少3秒）、mode（std或pro）、keep_original_sound（yes/no）、character_orientation（image/video）、prompt（提示词）、callback_url（回调URL）、async（可选，设为true时立即返回task_id）。
Kling Motion Generation API的同步调用和异步回调有什么区别？
同步调用时，API会等待视频生成完成（约1-2分钟）后返回结果，但长时间连接会消耗资源。异步回调时，客户端在请求中指定callback_url，API立即返回task_id，任务完成后通过POST JSON将结果发送到callback_url，其中包含task_id用于关联。
如何通过CURL调用Kling Motion Generation API？
使用POST请求到https://api.acedata.cloud/kling/motion，设置请求头accept: application/json、authorization: Bearer {token}、content-type: application/json，请求体包含image_url、video_url、prompt、mode、character_orientation等参数。示例代码见文档。
Kling Motion Generation API返回结果包含哪些字段？
返回结果包含：success（任务状态）、task_id（任务ID）、video_id（视频ID）、video_url（视频链接）、duration（视频时长）、state（任务状态）。
Kling Motion Generation API常见的错误代码有哪些？
常见错误代码：400 token_mismatched（参数缺失或无效）、400 api_not_implemented（参数缺失或无效）、401 invalid_token（授权token无效或缺失）、429 too_many_requests（请求频率超限）、500 api_error（服务器内部错误）。
