文档首页/云搜索服务 CSS_企业搜索服务 KooSearch/API参考/API/API/图片管理/上传图片 - UploadImage
更新时间：2026-03-18 GMT+08:00
查看PDF
分享

上传图片 - UploadImage

功能介绍

上传图片入库。

URI

POST /v1/{project_id}/applications/{application_id}/uni-search/img/{img_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，获取方法请参见获取项目ID。

约束限制：

不涉及

取值范围：

1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。

默认取值：

不涉及

application_id

是

String

参数解释：

应用ID，获取方法请参见获取应用ID。

约束限制：

字符串

取值范围：

1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。

默认取值：

不涉及

img_id

是

String

参数解释：

图片的id。

约束限制：

必须为32位的字母或数字，且以"img-"开头。

取值范围：

不涉及

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

接口鉴权使用的Token，Token获取方式参考：获取IAM用户Token。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

表3 FormData参数

参数

是否必选

参数类型

描述

image

是

File

参数解释：

上传的图片文件。

约束限制：

必须为png、jpg或jpeg格式，且大小不能超过20MB。

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

上传成功。

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及

error_msg

String

参数解释：

错误描述。

取值范围：

不涉及

状态码：500

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及

error_msg

String

参数解释：

错误描述。

取值范围：

不涉及

请求示例

  • 上传图片。

    /v1/b25446daeb1a41a7953c5deba2b2677a/applications/5071b12e-8c5c-4181-a15b-41e6ae3915ea/uni-search/img/img-00092484d4bf4582a7e3185f316e382b

Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="image"; filename="/D:/output/1e653a704c9e4e2aaa95f13fbe7ec1e3.jpeg"
Content-Type: image/jpeg

(data)
----WebKitFormBoundary7MA4YWxkTrZu0gW

  • 图片资源上传到指定知识库，指定文件内。

    /v1/b25446daeb1a41a7953c5deba2b2677a/applications/5071b12e-8c5c-4181-a15b-41e6ae3915ea/uni-search/img/img-00092484d4bf4582a7e3185f316e382b?repo_id=604c3237-cc0c-43f4-a22d-727df38a9eb7&file_id=112da243b82cb4362136129717d15dfe

Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="image"; filename="/D:/output/1e653a704c9e4e2aaa95f13fbe7ec1e3.jpeg"
Content-Type: image/jpeg

(data)
----WebKitFormBoundary7MA4YWxkTrZu0gW

响应示例

无

状态码

状态码

描述

200

上传成功。

400

请求错误。

500

内部异常。

错误码

请参见错误码。

父主题：图片管理