API 文档

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

API 服务概览

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

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

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

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

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

3. 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 →

积分管理

通过积分系统监控和管理您的 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. 积分管理

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

需要帮助？

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

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

语言支持

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