API 文档

欢迎使用 Kie.ai API 文档。本指南将帮助您了解如何有效地使用我们的 API 服务。

API 服务概览

我们目前提供以下 API 服务：

1. DeepSeek - 由DeepSeek提供的先进自然语言处理能力，基于大型语言模型技术

   • 实时对话接口
   • 上下文感知响应
   • 流式响应支持
   • 函数调用能力
   • JSON输出格式支持

2. 视频生成 - 使用Runway技术创建高质量AI视频，支持自定义内容和风格

   • 文本到视频生成
   • 图像到视频转换
   • 支持不同的宽高比（16:9 或 9:16）
   • 视频扩展能力
   • 异步处理的回调通知机制

3. 音乐生成 - 使用AI创作原创音乐，支持多种风格、自定义歌词和纯音乐选项

   • 文本到音乐生成
   • 自定义和非自定义生成模式
   • 音频扩展能力
   • 多种模型版本(V3.5 和 V4)
   • 异步处理与回调通知

4. 歌词生成 - 为音乐制作和歌曲创作生成创意丰富且上下文相关的歌词

   • 基于提示词创建歌词
   • 为音乐曲目创建结构化歌词内容
   • 带时间戳的歌词同步功能
   • 生成任务状态跟踪

5. WAV转换 - 将音频文件转换为专业级WAV格式，实现高质量声音处理和播放

   • 高质量音频转换
   • 适合专业音频工作流程
   • 比标准格式提供更高的音频质量

6. 人声分离 - 通过分离人声与音乐，提取人声或创建纯音乐版本

   • 从音乐中分离人声和伴奏
   • 创建卡拉OK伴奏轨道
   • 将现有音频处理为独立音轨

7. 音乐视频生成 - 将音频转换为视觉效果丰富的MP4视频，带有同步的视觉元素

   • 从音频创建视觉内容
   • 添加艺术家署名和品牌元素
   • 异步处理任务状态跟踪

8. 4o图像生成 - 使用先进的GPT-4o多模态模型创建细节丰富、创意十足的AI图像

   • 文本到图像生成
   • 基于最多5张参考图像的创作
   • 可自定义图像尺寸比例(1:1, 3:2, 2:3)
   • 异步处理与回调通知

9. 账户管理 - 监控和管理您的账户信息、积分余额、使用配额和API访问设置

   • 积分余额查询
   • 使用记录跟踪
   • API访问管理

基础信息

• API 服务器: https://kieai.erweima.ai
• API 版本: 1.0.0
• 技术支持: [email protected]

认证

所有 API 都需要使用 Bearer Token 认证：

Authorization: Bearer YOUR_API_KEY

获取您的 API Key：

1. 访问 API Key 管理页面
2. 生成您的专属 API Key
3. 在所有 API 请求中使用它

重要提示：

• 妥善保管您的 API Key
• 切勿与他人分享您的 API Key
• 如果怀疑泄露，请立即重置

API 服务

DeepSeek 对话

DeepSeek 对话 API 提供高级自然语言处理能力：

• 通过 /api/v1/chat/completions 提供实时对话接口
• 支持多种参数如温度、最大标记数和top_p
• 流式响应实现即时反馈
• 函数调用能力
• JSON输出格式支持

了解更多关于对话 API →

视频生成

视频生成 API 提供 AI 驱动的视频创作能力：

• 通过 /api/v1/runway/generate 从文本提示创建视频
• 将图像在文本引导下转换为视频
• 支持不同的宽高比（16:9 或 9:16）
• 通过 /api/v1/runway/extend 扩展现有视频
• 异步处理的 Webhook 回调机制
• 通过 /api/v1/runway/record-detail 查询生成状态

主要特点：

• 生成的视频存储期限为 14 天
• 视频生成是异步的，支持回调通知
• 支持纯文本和基于图像的生成方式
• 视频扩展保持视觉连贯性

了解更多关于视频生成 API →

音乐生成

音乐生成 API 提供 AI 驱动的音频创作能力：

• 通过 /api/v1/generate 从文本提示创建音乐曲目
• 支持纯音乐和带人声的音乐
• 自定义和非自定义生成模式
• 通过 /api/v1/generate/extend 提供音频扩展能力
• 通过 /api/v1/generate/get-timestamped-lyrics 支持带时间戳的歌词

主要特点：

• 生成的音频文件存储期限为 14 天
• 异步处理，支持回调通知
• 支持多种模型版本(V3.5 和 V4)
• 通过 /api/v1/generate/record-info 查询生成状态

了解更多关于音乐生成 API →

歌词生成

歌词生成 API 提供歌词创作能力：

• 基于文本提示生成歌词
• 为音乐曲目创建结构化歌词内容
• 查询歌词生成任务详情

主要特点：

• 每次请求生成多个歌词变体
• 提供生成进度的状态跟踪
• 敏感内容过滤的错误处理

了解更多关于歌词生成 API →

WAV转换

WAV转换 API 提供高质量音频格式转换：

• 通过 /api/v1/wav/generate 生成专业级WAV格式音频文件
• 适合专业音频制作工作流程
• 比标准格式提供更高的音频质量
• 通过 /api/v1/wav/record-info 查询转换状态

主要特点：

• 转换后的WAV文件保存14天
• 无压缩音频满足专业编辑需求
• 异步处理与状态跟踪

了解更多关于WAV转换 API →

人声分离

人声分离 API 提供音轨分离能力：

• 通过 /api/v1/vocal-removal/generate 从音轨中分离人声和伴奏
• 从音频文件中提取人声和伴奏组件
• 处理现有音频以创建独立的音轨
• 通过 /api/v1/vocal-removal/record-info 查询分离状态

主要特点：

• 所有三种音频文件(原始、人声、伴奏)保存14天
• 异步处理与状态跟踪
• 适合混音和卡拉OK应用场景

了解更多关于人声分离 API →

音乐视频生成

音乐视频生成 API 将音频转化为视觉内容：

• 通过 /api/v1/mp4/generate 从音频曲目生成 MP4 视频
• 创建带有同步视觉元素的音乐视频
• 添加艺术家署名和品牌选项
• 通过 /api/v1/mp4/record-info 查询视频生成状态

主要特点：

• 生成的视频存储期限为 14 天
• 异步处理任务状态跟踪
• 针对社交媒体分享优化

了解更多关于音乐视频生成 API →

4o Image 生成

4o Image API 提供 AI 驱动的图像生成能力：

• 通过 /api/v1/gpt4o-image/generate 创建AI生成的图像
• 支持基于提示词和基于图像的创作方式
• 可引用最多5张图像作为创作灵感
• 提供三种宽高比选择(1:1, 3:2, 2:3)
• 通过 /api/v1/gpt4o-image/record-info 查询生成任务详情

主要特点：

• 生成的图像存储期限为 14 天
• 异步处理，支持回调通知
• 多种生成状态用于跟踪进度
• 灵活的创作方式，支持从文本或参考图像创建

了解更多关于 4o Image API →

账户管理

通过账户管理系统监控和管理您的 API 使用：

• 通过 /api/v1/chat/credit 查看剩余积分
• 跟踪使用记录
• 设置使用提醒

了解更多关于账户管理 →

错误处理

我们的 API 使用标准的 HTTP 状态码和详细的错误信息：

状态码	说明
200	成功 - 请求已成功处理
401	未授权 - 认证凭证缺失或无效
402	积分不足 - 账户没有足够的积分执行操作
404	未找到 - 请求的资源或端点不存在
422	验证错误 - 请求参数未通过验证检查
429	请求限制 - 此资源的请求限制已超出
455	服务不可用 - 系统当前正在维护
500	服务器错误 - 处理请求时发生意外错误
505	功能已禁用 - 请求的功能当前已禁用

最佳实践

1. 认证

   • 安全存储您的 API Key
   • 定期轮换密钥以增强安全性
   • 为认证失败实现适当的错误处理

2. DeepSeek 对话

   • 根据创意需求设置适当的温度值
   • 使用流式响应实现响应式用户界面
   • 利用系统消息引导模型行为
   • 考虑使用函数调用获取结构化输出

3. 视频生成

   • 提供清晰描述视觉元素的详细提示词
   • 使用参考图像时，确保它们与目标宽高比匹配
   • 为异步结果实现稳健的回调处理
   • 存储任务ID进行状态检查并考虑14天的过期期限

4. 音乐生成

   • 初学者建议从非自定义模式开始简化使用
   • 在自定义模式中提供详细的风格指南以获得更好结果
   • 根据质量需求选择适当的模型版本
   • 为所有生成阶段实现适当的回调处理

5. 歌词生成

   • 在提示词中提供清晰的创意方向
   • 为内容过滤实现适当的错误处理
   • 存储任务ID以便状态检查和结果获取

6. WAV转换

   • 考虑与压缩格式相比的更大文件大小
   • 实现稳健的下载和存储策略
   • 在应用程序中为14天的文件过期做好计划

7. 人声分离

   • 适用于有清晰人声部分的专业录制音乐
   • 为所有三种输出类型(原始、人声、伴奏)实现播放功能
   • 考虑源音频复杂性对分离质量的影响

8. 音乐视频生成

   • 使用艺术家署名选项提升专业呈现效果
   • 为社交媒体平台优化播放和分享功能
   • 考虑音频长度对处理时间的影响

9. 4o图像生成

   • 提供清晰、描述性的提示词以获得更好的图像生成结果
   • 使用参考图像时，考虑使用多张图像提供更多创意控制
   • 根据应用需求指定适当的宽高比
   • 为不同的生成状态实现适当的错误处理

10. 账户管理

    • 定期监控积分使用情况
    • 为积分耗尽实现备用机制
    • 在适当情况下考虑缓存响应

需要帮助？

如果您遇到任何问题或有疑问，请通过以下方式联系我们：

• 📧 邮箱: [email protected]
• 💬 在线支持: 控制台
• 📚 API 参考: 完整文档

语言支持

本文档提供中英文两种语言版本。您可以使用导航栏中的语言选择器切换语言。