> ## Documentation Index
> Fetch the complete documentation index at: https://docs.powertokens.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 上传资产文件



## OpenAPI

````yaml api-reference/zh-Hans/assetLibrary/upload-file.json POST /v1/asset/upload
openapi: 3.1.0
info:
  title: 默认模块
  description: ''
  version: 1.0.0
servers:
  - url: https://powertokens.ai/api
    description: 生产环境
security: []
tags:
  - name: interface
paths:
  /v1/asset/upload:
    post:
      tags:
        - interface
      summary: 批量上传文件
      parameters:
        - name: Authorization
          in: header
          description: 官方API秘钥
          required: true
          example: XQujstE5wKqI0xecMJA8lQiq90OHygNIuI1X57zJqltTlOyY
          schema:
            type: string
        - name: User-Agent
          in: header
          description: 注意JAVA在不填写该值会被服务器拦截(eg:powertokensAi)
          required: false
          example: powertokensAi
          schema:
            type: string
        - name: Content-Type
          in: header
          description: multipart/form-data
          required: false
          example: multipart/form-data
          schema:
            type: string
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  format: binary
                  type: string
                  description: >-
                    文件（图片：JPEG、PNG、WebP、BMP、TIFF、GIF。< 30MB。比例
                    0.4-2.5。300-6000px，视频：MP4、MOV。480p/720p。2-15s。≤
                    50MB。24-60fps，音频：WAV、MP3。2-15s。≤ 15MB）
                  example: ''
                group_id:
                  description: 组ID（为空则创建虚拟组）
                  example: ''
                  type: string
              required:
                - file
            example:
              file: ''
              group_id: ''
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  data:
                    type: object
                    properties:
                      task_id:
                        type: string
                    required:
                      - task_id
                  msg:
                    type: string
                required:
                  - code
                  - data
                  - msg
              example:
                code: 200
                data:
                  task_id: task_2605191840200001
                msg: ''
          headers: {}
      deprecated: false
      security: []

````