API 文档

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

API 服务概览

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

1. DeepSeek - 由 DeepSeek 提供支持的大语言模型 API 接口

   • 实时对话接口
   • 上下文感知响应
   • 流式响应支持

2. Runway - 使用 Runway 生成模型的 AI 视频生成接口

   • 文本到视频生成
   • 图像到视频转换
   • 回调通知机制

3. Suno - AI 音频生成服务，用于创建音乐和人声内容

   • 带或不带歌词的音乐生成
   • 带时间戳的歌词创建
   • WAV 格式高质量音频
   • 人声分离和音轨分离
   • MP4 视频从音频生成

4. Account - 账户信息、积分余额和使用额度管理接口

   • 积分余额查询
   • 使用记录跟踪

基础信息

• 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 →

Runway 视频生成

Runway API 提供 AI 视频生成能力：

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

主要特点：

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

了解更多关于 Runway API →

Suno 音频生成

Suno API 提供 AI 驱动的音频和音乐生成能力：

音频生成

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

主要特点：

• 生成的音频文件存储期限为 14 天
• 异步处理，支持回调通知
• 支持多种模型版本(V3.5 和 V4)

歌词生成

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

WAV 格式音频

• 生成高质量 WAV 格式音频文件
• 适合专业音频制作工作流程
• 比标准格式提供更高的音频质量

人声分离

• 从音频中分离人声和伴奏
• 从音频文件中提取人声和伴奏组件
• 处理现有音频以创建独立的音轨

MP4 生成

• 通过 /api/v1/mp4/generate 从音频曲目生成 MP4 视频
• 为生成的歌曲创建视觉音乐视频
• 通过 /api/v1/mp4/record-info 查询 MP4 生成任务详情
• 异步处理，支持任务状态跟踪

了解更多关于 Suno API →

积分管理

通过积分系统监控和管理您的 API 使用：

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

了解更多关于积分 →

错误处理

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

状态码	说明
100	已执行 - 待执行
200	成功 - 请求成功完成
300	回答中
401	未授权 - 需要认证或认证失败
402	使用次数已用尽 - 使用次数已耗尽
404	未找到 - 无效的请求方法或路径
422	参数错误 - 错误的参数代码
429	积分不足 - 账户积分余额不足
500	服务器错误 - 发生内部服务器错误
505	聊天已禁用 - 聊天禁用错误代码

最佳实践

1. 认证

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

2. DeepSeek 对话

   • 根据创意需求设置适当的温度值
   • 使用流式响应实现响应式用户界面
   • 利用系统消息引导模型行为

3. Runway 视频生成

   • 为异步结果实现稳健的回调处理
   • 存储任务ID以便状态检查
   • 在应用程序中为14天的视频过期做好准备

4. Suno 音频生成

   • 根据质量需求选择适当的模型版本
   • 使用自定义模式以更好地控制音乐生成
   • 为所有生成阶段实现适当的回调处理
   • 考虑使用 WAV 格式用于专业音频应用
   • 利用人声分离功能进行音频处理
   • 使用 MP4 生成功能为您的音频曲目创建视觉内容

5. 积分管理

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

需要帮助？

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

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

语言支持

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