文档首页/ 智能体平台 Versatile/ API参考/ API/ 智能体/ 上传文件
更新时间：2025-09-16 GMT+08:00
查看PDF
分享

上传文件

功能介绍

该接口用于智能体上传文件，支持多种图片、文档、表格等多种格式的文件上传。接口返回临时下载路径，可用于临时下载文件。

适用场景：在智能体应用中上传文件。

格式要求：

  • 办公文档：DOC、DOCX、XLS、XLSX、PPT、PPTX、PDF、Numbers、CSV。

  • 图像文件：JPG、JPEG、PNG、GIF、WEBP、HEIC、HEIF、BMP、PCD、TIFF。

  • 音频文件：WAV、MP3、FLAC、M4A、AAC、OGG、WMA、MIDI。

  • 文本文件：JS、CPP、PY、JAVA、C、TXT、CSS、JAVASCRIPT、HTML、JSON、MD。

URI

POST /v1/{project_id}/agent-runtime/upload-file

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

当前租户项目ID。

获取方法请参考获取项目ID。

约束限制：

不涉及。

取值范围：

由英文，数字，“-”，“_”组成，不超过64位字符。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

workspace_id

是

String

参数解释：

工作空间ID，用于标识特定的工作空间。

获取方法请参考获取工作空间ID。

约束限制：

不涉及。

取值范围：

由英文，数字，“-”，“_”组成，不超过64位字符。

默认取值：

不涉及。

file

是

Object

参数解释：

上传的文件。

约束限制：

不涉及。

取值范围：

大小不超过60MB。

默认取值：

不涉及。

expires

否

Integer

参数解释：

访问授权过期时间（天）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

is_image

否

Boolean

参数解释：

是否是图片上传。

约束限制：

不涉及。

取值范围：

  • 是：文件为图片格式。

  • 否：文件为非图片格式。

默认取值：

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 请求Body参数

参数

是否必选

参数类型

描述

file

是

String

参数解释：

用户上传的文档。

约束限制：

不涉及。

取值范围：

文件大小小于60MB。

默认取值：

不涉及。

is_image

否

Boolean

参数解释：

用户上传的文档是否是图片。

约束限制：

不涉及。

取值范围：

  • 是：文件为图片格式。

  • 否：文件为非图片格式。

默认取值：

不涉及。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

url

String

参数解释：

临时有效，用于访问存储在华为云 OBS 上的文件的下载地址。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

headers

Object

参数解释：

请求访问的域名，是华为云OBS签名验证的关键信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

file_name

String

参数解释：

文件名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求示例

{
  "method" : "POST",
  "url" : "https://api.example.com/v1/{project_id}/agent-runtime/upload-file",
  "headers" : {
    "Content-Type" : "application/json",
    "X-Auth-Token" : "MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...",
    "stream" : true
  },
  "body" : {
    "file" : "C:\\Users\\Desktop\\market-CFrwA1xu.png"
  }
}

响应示例

状态码：200

Agent文件上传结束的响应体。

{
  "url" : "https://test-agent-poc.obs.cn-north-7.ulanqab.huawei.com:443/file/3fd960a8-ca5d-4423-b8da-bb8866e21c28.docx?AccessKeyId=8SL1ZFP1ELHHMAWYJHCJ&Expires=1758282352&Signature=r02Qxi3%2Bhv1FtnMo3XcCvReBQGo%3D",
  "headers" : [ {
    "Host" : "test-agent-poc.obs.cn-north-7.ulanqab.huawei.com:443"
  } ]
}

状态码

状态码

描述

200

Agent文件上传结束的响应体。

错误码

请参见错误码。

父主题： 智能体

相关文档