获取生成文件的下载链接
本页由 ModelFold 文档站根据上游官方 OpenAPI 文档同步生成。接口路径、参数、示例与官方保持一致；品牌与 API 域名已替换为 ModelFold。
接口
POST /common/download-url
完整 URL: https://ai.modelfold.online/v1/common/download-url
鉴权：所有请求都需要
Authorization: Bearer <API_KEY>请求头。
TIP
将生成的文件URL转换为可下载的临时链接。仅支持ModelFold 服务生成的文件。
功能特性
- 将ModelFold 生成的文件URL转换为可下载链接
- 支持任务结果中的文件地址（如 resultUrls、audio_url），不支持文件上传 API 返回的地址。
- 临时下载链接有效期为20分钟
- 安全访问生成的内容
- API Key身份验证保护
重要说明
WARNING
支持任务结果中的文件地址（如 resultUrls、audio_url），不支持文件上传 API 返回的地址。
TIP
可下载链接20分钟后过期。请确保在此时间范围内下载或缓存内容。
请求参数
请求体 (application/json)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 任务结果中的文件地址（如 resultUrls[0]），支持图片、视频、音频。 示例：https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98。 |
请求示例
bash
curl -X POST "https://ai.modelfold.online/v1/common/download-url" \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"
}'json
{
"url": "https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"
}响应
200 — 请求成功
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 否 | 请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。 可选值：200 / 401 / 402 / 404 / 422 / 429 / 455 / 500 / 505。 示例：200。 |
msg | string | 否 | 当 code != 200 时的错误信息 示例：success。 |
data | string | 否 | 文件的可下载链接。有效期为20分钟。 示例：https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98。 |
json
{
"code": 200,
"msg": "success",
"data": "https://tempfile.1f6cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxbd98"
}