欢迎使用 Luma API!
本快速开始指南将引导您完成使用最先进的 AI 模型开始修改视频的基本步骤。概述
生成的视频是异步处理的。使用回调或轮询来跟踪完成状态。
身份验证
所有 API 请求都需要通过 Bearer Token 进行身份验证。1
获取您的 API Key
访问 API Key 管理页面 获取您的 API key。
2
添加到请求头
在所有请求中包含您的 API key:
请保护好您的 API key,永远不要公开分享。如果泄露,请立即在管理页面重置。
基本用法
1. 修改现有视频
首先创建您的第一个视频修改任务:2. 检查生成状态
使用返回的taskId
监控进度:
0
: 生成中 - 任务正在处理中1
: 成功 - 任务成功完成2
: 创建任务失败 - 无法创建任务3
: 生成失败 - 任务创建成功但生成失败4
: 回调失败 - 生成成功但回调失败
完整工作流示例
这是一个修改视频并等待完成的完整示例:高级功能
水印支持
为生成的视频添加水印:使用回调
设置 webhook 回调以获取自动通知:了解更多关于回调
设置 webhook 回调以在视频准备就绪时接收自动通知。
错误处理
常见错误场景及处理方法:无效视频 URL(代码 422)
无效视频 URL(代码 422)
生成失败(代码 501)
生成失败(代码 501)
频率限制(代码 429)
频率限制(代码 429)
最佳实践
性能优化
- 使用回调:设置 webhook 回调而不是轮询以获得更好的性能
- 提示工程:使用详细、具体的提示以获得更好的结果
- 视频预处理:确保输入视频经过优化且可访问
- 下载管理:及时下载生成的视频,因为它们可能会过期
- 错误处理:实施强大的错误处理和重试逻辑
重要限制
- 语言支持:提示仅支持英语
- 视频存储:生成的视频可能在一定时间后过期
- 文件大小:最大视频大小为 500MB
- 时长:最大视频时长为 10 秒
- 输入视频:必须是可公开访问的 URL
- 处理时间:视频生成可能需要几分钟
支持的参数
核心参数
参数 | 类型 | 描述 | 必填 |
---|---|---|---|
prompt | string | 必填。视频修改的文本描述 | ✓ |
videoUrl | string | 必填。用于修改的输入视频 URL | ✓ |
可选参数
参数 | 类型 | 描述 | 默认值 |
---|---|---|---|
callBackUrl | string | Webhook 通知 URL | - |
watermark | string | 水印标识符 | - |
下一步
支持
需要帮助?以下是您的选择:- 技术支持:support@kie.ai
- API 状态:监控服务健康和公告
- 文档:探索详细的 API 参考
- 社区:加入我们的开发者社区获取提示和示例