# 上传媒体文件

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /upload:
    post:
      summary: 上传媒体文件
      deprecated: false
      description: ''
      tags:
        - HTTP接口/媒体文件上传
      parameters:
        - name: client_type
          in: query
          description: 声明请求黑盒语音
          required: true
          example: heybox_chat
          schema:
            type: string
            default: heybox_chat
        - name: x_client_type
          in: query
          description: 声明客户端类型
          required: true
          example: web
          schema:
            type: string
            default: web
        - name: os_type
          in: query
          description: 声明客户端类型
          required: true
          example: web
          schema:
            type: string
            default: web
        - name: x_os_type
          in: query
          description: 声明客户端是bot
          required: true
          example: bot
          schema:
            type: string
            default: bot
        - name: x_app
          in: query
          description: 声明请求黑盒语音
          required: true
          example: heybox_chat
          schema:
            type: string
            default: heybox_chat
        - name: chat_os_type
          in: query
          description: 声明客户端是bot
          required: true
          example: bot
          schema:
            type: string
            default: bot
        - name: chat_version
          in: query
          description: 客户端版本号,不同版本返回的结果可能有区别
          required: true
          example: 1.30.0
          schema:
            type: string
            default: 1.30.0
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  example: ./4.jpeg
                  type: string
                  format: binary
              required:
                - file
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                status: ok
                msg: ''
                version: '1.0'
                result:
                  url: >-
                    https://chat.max-c.com/attachments/2024-09-03/1830949620579045376_xWKtFCRPWo.png
          headers: {}
          x-apifox-name: 成功
      security:
        - apikey-header-token: []
      x-apifox-folder: HTTP接口/媒体文件上传
      x-apifox-status: developing
      x-run-in-apifox: https://app.apifox.com/web/project/4856361/apis/api-196172729-run
components:
  schemas: {}
  securitySchemes:
    token:
      type: apikey
      in: header
      name: token
      token: ODYzNzY0NDM7MTc1NTc1OTk1NzYyODYzNjQ0NzsxNTU0MDM2NTkxNzk2OTM1OTY5
    apikey-header-token:
      type: apiKey
      in: header
      name: token
servers:
  - url: http://prod-cn.your-api-server.com
    description: 正式环境
security:
  - apikey-header-token: []

```