Luma API 快速开始

在几分钟内开始使用 Luma API。学习如何使用先进的 AI 模型修改和转换视频。

欢迎使用 Luma API！

本快速开始指南将引导您完成使用最先进的 AI 模型开始修改视频的基本步骤。

概述

视频修改

使用 AI 驱动的修改和增强功能转换现有视频

任务跟踪

实时状态跟踪和 webhook 回调通知

生成的视频是异步处理的。使用回调或轮询来跟踪完成状态。

身份验证

所有 API 请求都需要通过 Bearer Token 进行身份验证。

1. 获取您的 API Key

访问 API Key 管理页面获取您的 API key。

2. 添加到请求头

在所有请求中包含您的 API key：

请保护好您的 API key，永远不要公开分享。如果泄露，请立即在管理页面重置。

基本用法

1. 修改现有视频

首先创建您的第一个视频修改任务：

Node.js

Python

cURL

响应：

{\n  "code": 200,\n  "msg": "success",\n  "data": {\n    "taskId": "774d9a7dd608a0e49293903095e45a4c"\n  }\n}

2. 检查生成状态

使用返回的 taskId 监控进度：

Node.js

Python

cURL

状态值：

0: 生成中 - 任务正在处理中

1: 成功 - 任务成功完成

2: 创建任务失败 - 无法创建任务

3: 生成失败 - 任务创建成功但生成失败

4: 回调失败 - 生成成功但回调失败

完整工作流示例

这是一个修改视频并等待完成的完整示例：

JavaScript

Python

高级功能

水印支持

为生成的视频添加水印：

使用回调

设置 webhook 回调以获取自动通知：

了解更多关于回调

设置 webhook 回调以在视频准备就绪时接收自动通知。

错误处理

常见错误场景及处理方法：

无效视频 URL（代码 422）

生成失败（代码 501）

频率限制（代码 429）

最佳实践

性能优化

使用回调：设置 webhook 回调而不是轮询以获得更好的性能

提示工程：使用详细、具体的提示以获得更好的结果

视频预处理：确保输入视频经过优化且可访问

下载管理：及时下载生成的视频，因为它们可能会过期

错误处理：实施强大的错误处理和重试逻辑

重要限制

语言支持：提示仅支持英语

视频存储：生成的视频可能在一定时间后过期

文件大小：最大视频大小为 500MB

时长：最大视频时长为 10 秒

输入视频：必须是可公开访问的 URL

处理时间：视频生成可能需要几分钟

支持的参数

核心参数

参数	类型	描述	必填
`prompt`	string	必填。视频修改的文本描述	✓
`videoUrl`	string	必填。用于修改的输入视频 URL	✓

可选参数

参数	类型	描述	默认值
`callBackUrl`	string	Webhook 通知 URL	-
`watermark`	string	水印标识符	-

支持

需要帮助？以下是您的选择：

技术支持：support@kie.ai

API 状态：监控服务健康和公告

文档：探索详细的 API 参考

社区：加入我们的开发者社区获取提示和示例

Luma API 快速开始

欢迎使用 Luma API！#

概述#

身份验证#

1. 获取您的 API Key#

2. 添加到请求头#

基本用法#

1. 修改现有视频#

2. 检查生成状态#

完整工作流示例#

高级功能#

水印支持#

使用回调#

错误处理#

最佳实践#

性能优化#

重要限制#

支持的参数#

核心参数#

可选参数#

支持#

欢迎使用 Luma API！

概述

身份验证

1. 获取您的 API Key

2. 添加到请求头

基本用法

1. 修改现有视频

2. 检查生成状态

完整工作流示例

高级功能

水印支持

使用回调

错误处理

最佳实践

性能优化

重要限制

支持的参数

核心参数

可选参数

支持