跳转到主要内容
POST
/
api
/
v1
/
common
/
download-url
获取生成文件的下载链接
curl --request POST \
  --url https://api.kie.ai/api/v1/common/download-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"
}'
{
  "code": 200,
  "msg": "success",
  "data": "https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"
}
将生成的文件URL转换为可下载的临时链接。仅支持kie.ai服务生成的文件。

​
功能特性

  • 将kie.ai生成的文件URL转换为可下载链接
  • 支持kie.ai平台生成的所有文件类型（图片、视频、音频等）
  • 临时下载链接有效期为20分钟
  • 安全访问生成的内容
  • API Key身份验证保护

​
重要说明

仅支持kie.ai服务生成的文件URL。外部文件URL将返回422验证错误。
可下载链接20分钟后过期。请确保在此时间范围内下载或缓存内容。

Authorizations

​
Authorization
string
header
required

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式: 在请求头中添加： Authorization: Bearer YOUR_API_KEY

Body

application/json
​
url
string<uri>
required

kie.ai服务生成的文件URL。不支持外部文件URL。

Example:

"https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"

Response

请求成功

​
code
enum<integer>

响应状态码

Code说明
200成功 - 请求已成功处理
401未授权 - 缺少身份验证凭据或凭据无效
402积分不足 - 账户没有足够的积分执行此操作
404未找到 - 请求的资源或接口不存在
422参数错误 - URL无效（不支持外部文件URL）
429超出限制 - 已超过该资源的请求限制
455服务不可用 - 系统维护中
500服务器错误 - 处理请求时发生意外错误
505功能已禁用 - 当前功能不可用
可用选项:
200,
401,
402,
404,
422,
429,
455,
500,
505
​
msg
string

当 code != 200 时的错误信息

Example:

"success"

​
data
string<uri>

文件的可下载链接。有效期为20分钟。

Example:

"https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"