j9九游会登录/ 智能体平台 agentarts/ api参考/ api/ 工作流/智能体/ 上传文件 - agentuploadfile
更新时间：2026-02-06 gmt 08:00
查看pdf

上传文件 -j9九游会登录

功能介绍

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

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

格式要求：

  • 办公文档：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。

调用方法

请参见如何调用api。

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

参数解释：

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

约束限制：

最长180天。

取值范围：

不涉及。

默认取值：

不涉及。

is_image

否

boolean

参数解释：

是否是图片上传。

约束限制：

不涉及。

取值范围：

  • true：文件为图片格式。

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

默认取值：

false。

请求参数

表3 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

是

string

参数解释：

用户token。通过调用iam服务获取用户token接口获取（响应消息头中x-subject-token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

content-type

是

string

参数解释：

发送的实体的mime类型。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

application/json。
表4 请求body参数

参数

是否必选

参数类型

描述

file

是

string

参数解释：

用户上传的文档。

约束限制：

不涉及。

取值范围：

文件大小小于60mb。

默认取值：

不涉及。

is_image

否

boolean

参数解释：

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

约束限制：

不涉及。

取值范围：

  • true：文件为图片格式。

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

默认取值：

false。

响应参数

状态码：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?workspace_id={workspace_id}",
  "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+hv1ftnmo3xccvrebqgo=",
  "headers" : [ {
    "host" : "test-agent-poc.obs.cn-north-7.ulanqab.huawei.com:443"
  } ]
}

状态码

状态码

描述

200

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

错误码

请参见错误码。

父主题： 工作流/智能体

相关文档

网站地图