Ae · File · Service · Get · Upload · Addr
0.00积分/次
ae_file_service_get_upload_addr
根据本地文件的大小、扩展名和上传链接有效期,获取临时文件上传链接和公开下载 URL。 单个上传文件最大 500 MiB(524,288,000 字节);上传地址有效期最长 30 天(43,200 分钟)。
0.00积分/次
价格说明
0.00积分/次
API 调用
通过统一工具网关发起同步请求,鉴权和计费由 AgentEarth 处理。
cURL
curl --request POST \
--url 'https://api.agentearth.ai/v1/tools/run' \
--header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"tool": "ae_file_service_get_upload_addr",
"input": {
"ext": "xxx",
"size_bytes": "xxx",
"ttl_minutes": "xxx"
}
}'- 请求方式
- POST
- 接口地址
- /v1/tools/run
- 鉴权方式
- Bearer Token
- 超时时间
- 60 秒
- 当前版本
- —
响应示例
{
"error_no": 0,
"error_msg": "",
"result": [
{
"type": "text",
"text": "xxx"
}
],
"platform_annotations": {
"source": "AgentEarth",
"platform_note": "xxx",
"platform_suggestion": "xxx"
}
}工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
ext | string | 是 | 文件扩展名,不含点号,只允许字母和数字,不区分大小写 | — |
size_bytes | integer | 是 | 单个文件大小,单位 byte。必须大于 0,最大 524,288,000 字节(500 MiB,含上限);传入实际文件字节数。 | — |
ttl_minutes | integer | 是 | 上传地址有效期,单位分钟。必须大于 0,最大 43,200 分钟(30 天,含上限);根据需要设置有效期。 | — |
