跳转到主要内容
POST
/
api
/
v1
/
gpt4o-image
/
download-url
获取直接下载URL
curl --request POST \
  --url https://api.kie.ai/api/v1/gpt4o-image/download-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "taskId": "task12345",
  "url": "https://tempfile.aiquickdraw.com/v/xxxxxxx.png"
}'
{
  "code": 200,
  "msg": "success",
  "data": "https://xxxxxx.xxxxxxxx.r2.cloudflarestorage.com/v/xxxxxxx.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250415T101007Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1200&X-Amz-Credential=2464206aa3e576aa7c035d889be3a84e%2F20250415%2Fapac%2Fs3%2Faws4_request&X-Amz-Signature=122ae8bef09110e620841ab2ef8061c1818e754fc201408a9d1c6847b36fd3df"
}

Authorizations

​
Authorization
string
header
required

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

获取 API Key:

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

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

注意事项：

  • 请妥善保管您的 API Key，不要泄露给他人
  • 如果怀疑 API Key 泄露，请立即在管理页面重置

Body

application/json
​
taskId
string
required

与图片生成相关的任务ID

Example:

"task12345"

​
url
string<uri>
required

需要转换为直接下载URL的原始图片URL

Example:

"https://tempfile.aiquickdraw.com/v/xxxxxxx.png"

Response

请求成功

​
code
enum<integer>

响应状态码

  • 200: 成功 - 请求已成功处理
  • 401: 未授权 - 缺少身份验证凭据或凭据无效
  • 404: 未找到 - 请求的资源或端点不存在
  • 422: 参数错误
    • 请求参数未通过验证检查
    • 记录为空
    • 暂时支持 14 天内的记录
    • 记录结果数据为空
    • 记录状态不是成功
    • 记录结果数据不存在
  • 451: 获取图片失败。请验证您或您的服务提供商设置的任何访问限制
  • 455: 服务不可用 - 系统当前正在进行维护
  • 500: 服务器错误 - 在处理请求时发生意外错误
可用选项:
200,
401,
404,
422,
451,
455,
500
​
msg
string

当 code != 200 时的错误信息

Example:

"success"

​
data
string

有效期为20分钟的直接下载URL

Example:

"https://xxxxxx.xxxxxxxx.r2.cloudflarestorage.com/v/xxxxxxx.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250415T101007Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1200&X-Amz-Credential=2464206aa3e576aa7c035d889be3a84e%2F20250415%2Fapac%2Fs3%2Faws4_request&X-Amz-Signature=122ae8bef09110e620841ab2ef8061c1818e754fc201408a9d1c6847b36fd3df"