抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 列表
  • 通用参数
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 搜索能力
  • 私信群聊
  • 群聊管理
  • 经营工具
  • 留资卡片
  • 小程序引导卡片
  • 图片上传
  • 获取消息中的多媒体资源
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划
  • 图片上传

    收藏
    我的收藏

    接口说明

    该接口用于上传图片,返回的 image_id 作为建群接口的 avatar_uri 字段传入。
    返回的 image_id,可用于 创建/更新留资卡片, 创建更新小程序引导卡片模板 等接口的图片参数。

    使用限制

      图片不超过 10 MB
      仅支持 jpeg, png, bmp, webp 图片格式

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/tool/imagex/client_upload/
    HTTP Method
    POST
    Scope
    tool.image.upload
    权限要求

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    Content-Type必填String
    固定值"multipart/form-data"
    Body
    image必填Binary
    示例:image
    图片
    请求示例
    curl --location 'https://open.douyin.com/tool/imagex/client_upload/' \ --header 'access-token: clt.2.PHIvk97aUgSAUZ_Nn7SgbFLuxNH2dxvZaFkJb6IZuu4v8JDO06YwUNX4QpVeMDFUZx_o6sS7kEUokA0vB4ZDmKNV-KzlBfq4ntVSdmT5_RE9tuZWsTPc-9ZZLVYjheQbu7siGOOe4uA-zVSW0YJDZYwVG6eiNbl9VZQEOTPiTnovxCS_uk8dBmW1VaU=' \ --form 'image=@"/path/to/file"'

    响应参数

    Body展开全部子属性
    data必填Struct
    展开子属性
    height必填Int32
    示例:360
    图片高度
    width必填Int32
    示例:360
    图片宽度
    extraStruct
    错误信息
    展开子属性
    image_idString
    图片id
    md5String
    图片md5
    响应示例
    正常响应示例异常响应示例
    { "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": "" }
    切换单列布局