KIE.AI
Chinese
  • English
  • Chinese
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Common API
  • 通用 API 快速入门
  • Webhook 安全校验
  • 获取剩余积分
    GET
  • 获取生成文件的下载链接
    POST
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Common API

通用 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 服务!
Next
Webhook 安全校验
Built with