抖音开放平台Logo
开发者文档
移动/网站应用
“/”唤起搜索
控制台
  • OpenAPI 列表
  • 通用参数
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 搜索能力
  • 私信群聊
  • 生活服务开放能力
  • 工具能力
  • 素材管理
  • 上传素材接口
  • 上传临时素材接口
  • 素材列表接口
  • 删除素材接口
  • 小程序接口能力
  • 沙盒管理
  • ticket 管理
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权

    • 上传临时素材接口
    收藏
    我的收藏

    使用限制

    目前支持的素材如下：
    类型
    大小
    格式
    其他说明
    图片
    5MB
    bmp/gif/png/jpeg/jpg
    长度<1500
    宽度<1500
    PDF
    10MB
    pdf
    ​
    ​

    接口说明

    用于上传临时素材。
    ​

    基本信息

    名称
    描述
    HTTP URL
    https://open.douyin.com/enterprise/media/temp/upload/
    HTTP Method
    POST
    Scope
    enterprise.im
    权限要求
    当前暂不支持新增申请

    请求头

    参数名称
    类型
    参数描述
    参数示例
    是否必填
    Content-Type
    string
    固定值：multipart/form-data
    multipart/form-data
    是

    请求参数

    Query

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    open_id
    string
    用户唯一标志。通过调用 https://open.douyin.com/oauth/access_token/ 生成的 open_id 字段获取
    ba253642-0590-40bc-9bdf-9a1334b94059
    是
    access_token
    string
    接口调用凭证。通过调用 https://open.douyin.com/oauth/access_token/生成的 access_token 字段获取
    act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr
    是

    Body

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    media
    byte[]
    素材文件。若素材为图片，则长宽不能大于 1500，大小建议不超过 5MB。
    <nil>
    否

    请求示例

    curl -X POST "https://open.douyin.com/enterprise/media/temp/upload/?open_id=ba253642-0590-40bc-9bdf-9af334b94059&access_token=act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Eoi" \
  -H "Content-Type: multipart/form-data" \
  -F "media=@/path/to/your/file.jpg"
    ​

    响应参数

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    extra
    struct
    ​
    <nil>
    ​
    - sub_description
    string
    子错误码描述
    ​
    ​
    - sub_error_code
    int64
    子错误码
    0
    false
    - description
    string
    错误码描述
    ​
    false
    - error_code
    int64
    错误码
    0
    false
    - logid
    string
    标识请求的唯一 id
    202008121419360101980821035705926A
    false
    - now
    int64
    毫秒级时间戳
    1597213176393
    false
    data
    struct
    ​
    <nil>
    ​
    - description
    string
    错误码描述
    ​
    false
    - error_code
    int64
    错误码
    0
    false
    - media
    struct
    ​
    <nil>
    false
    -- media_id
    string
    ​
    <nil>
    false
    -- url_list
    string[]
    ​
    <nil>
    false

    响应示例

    正常示例

    {
  "data": {
    "description": "",
    "error_code": "0",
    "media": {
      "media_id": "<nil>",
      "url_list": ["<nil>"]
    }
  },
  "extra": {
    "description": "",
    "error_code": "0",
    "logid": "202008121419360101980821035705926A",
    "now": "1597213176393",
    "sub_description": "",
    "sub_error_code": "0"
  }
}

    异常示例

    {
  "data": {
    "description": "Parameter error",
    "error_code": 2100005
  },
  "extra": {
    "logid": "2020070614111601022506808001045D59",
    "now": 1594015876138
  }
}
    ​

    错误码

    HTTP 状态码
    错误码
    错误码描述
    排查建议
    200
    2100005
    Parameter error
    修改参数取值
    ​