通用 API 快速入门

用于账户管理和文件操作的基础实用 API

欢迎使用通用 API

通用 API 提供用于管理您的 kie.ai 账户和处理生成内容的基础实用服务。这些 API 能帮助您监控积分使用情况并高效地访问已生成的文件。

查询账户积分

查看您当前的积分余额并监控使用情况

获取下载链接

为已生成的文件生成临时下载链接

身份验证

所有 API 请求都需要使用 Bearer 令牌进行身份验证。请从 API 密钥管理页面获取您的 API 密钥。

请妥善保管您的 API 密钥，切勿公开分享。如果您怀疑密钥已泄露，请立即重置。

API 基础 URL (Base URL)

https://api.kie.ai

认证 Header

快速入门指南

第一步：检查积分余额

监控您的账户积分，以确保有足够的余额持续使用服务：

cURL

JavaScript

Python

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": 100
}

第二步：获取生成文件的下载链接

将生成文件的 URL 转换为临时的可下载链接：

cURL

JavaScript

Python

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": "https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"
}

下载链接有效期仅为 20 分钟。请确保在此时间内下载或缓存内容。

API 概览

查询账户积分

GET /api/v1/chat/credit

用途：监控您的账户积分余额

特性：

实时获取积分余额

无需任何参数

即时响应

监控使用情况必不可少

使用场景：

在开始生成任务前检查积分

监控积分消耗模式

规划积分充值

实现积分阈值预警

获取下载链接

POST /api/v1/common/download-url

用途：为已生成的文件生成临时下载链接

特性：

支持所有 kie.ai 生成的文件类型（图像、视频、音频等）

20 分钟有效期

安全的认证访问

仅适用于 kie.ai 生成的 URL

使用场景：

下载生成内容到本地存储

与团队成员分享临时链接

集成到外部系统

构建自定义下载工作流

实战示例

积分监控系统

实现一个自动化的积分监控系统：

JavaScript

Python

错误处理

常见错误及处理方法：

401 Unauthorized (未授权)

422 Validation Error (验证错误 - 下载链接)

402 Insufficient Credits (积分不足)

500 Server Error (服务器错误)

最佳实践

积分管理

定期监控：在开始大批量操作前检查积分

设置预警：当积分低于阈值时，实施自动化报警

预算规划：追踪积分消耗模式以便更好地进行规划

优雅降级：适当处理积分不足的情况

下载链接使用

时效性：下载链接在 20 分钟后过期

适当缓存：获取下载链接后立即保存文件

批量下载：在时限内高效处理多个文件

错误处理：为失败的下载实施重试逻辑

性能优化

并行处理：并发下载多个文件（需遵守速率限制）

连接池：复用 HTTP 连接进行多次请求

超时设置：为下载操作设置合理的超时时间

进度追踪：为长时间运行的操作实现进度指示

安全考量

API 密钥保护：切勿在客户端代码中暴露 API 密钥

仅限 HTTPS：始终使用 HTTPS 进行 API 请求

密钥轮换：定期轮换 API 密钥以确保安全

访问日志：保留 API 使用日志以供审计

重要提示

下载链接过期：临时下载链接有效期仅为 20 分钟。请确保：

获取 URL 后立即下载文件

实现过期 URL 的错误处理

缓存下载内容以供将来使用

积分余额：当积分耗尽时，服务访问将受限。请务必：

定期监控积分余额

设置低积分预警

提前规划积分充值

在积分较低时实现优雅降级

支持的 URL：下载链接端点仅支持由 kie.ai 服务生成的文件。外部文件 URL 将导致 422 验证错误。

集成示例

市场 API

探索 AI 模型市场 API

文件上传 API

上传文件以进行处理

技术支持

需要帮助？我们的技术支持团队随时为您服务。

电子邮箱: support@kie.ai

文档: docs.kie.ai

API 状态: 查看我们的状态页面以获取实时 API 健康状况

通用 API 快速入门

欢迎使用通用 API#

身份验证#

API 基础 URL (Base URL)#

认证 Header#

快速入门指南#

第一步：检查积分余额#

第二步：获取生成文件的下载链接#

API 概览#

查询账户积分#

获取下载链接#

实战示例#

积分监控系统#

错误处理#

最佳实践#

重要提示#

集成示例#

技术支持#

欢迎使用通用 API

身份验证

API 基础 URL (Base URL)

认证 Header

快速入门指南

第一步：检查积分余额

第二步：获取生成文件的下载链接

API 概览

查询账户积分

获取下载链接

实战示例

积分监控系统

错误处理

最佳实践

重要提示

集成示例

技术支持