图片上传

开发环境

http://dev-cn.your-api-server.com

POST

/tool/imagex/client_upload/

scope: tool.image.upload 需要申请权限不需要用户授权

该接口用于上传图片，返回的 image_id 作为建群接口的 avatar_uri 字段传入。

使用限制

图片不超过 10 MB

仅支持 jpeg, png, bmp, webp 图片格式

接口说明

返回的 image_id，可用于创建/更新留资卡片, 创建更新小程序引导卡片模板等接口的图片参数

权限要求

新能力上线能力实验室后，经营者可在“控制台-能力管理-能力实验室”中申请。后期能力若转为正式开放能力，可在“控制台-能力管理-互动管理”中申请。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/tool/imagex/client_upload/' \
--header 'Authorization: Bearer <token>' \
--form 'image="/path/to/file"'

响应示例

{
  "extra": {
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1648797449,
    "logid": "021648797449846fd1b1111000700600000000000000086dfb920",
    "error_code": 0
  },
  "data": {
    "error_code": 0,
    "description": ""
  },
  "image_id":"@baihq==",
  "width":111
  "height":111
  "md5":""
}

修改于 2025-11-07 09:38:29

删除小程序引导卡片模板

创建线索组件

图片上传

使用限制#

接口说明#

权限要求#

请求参数

返回响应

使用限制

接口说明

权限要求