{
  "openapi": "3.1.0",
  "info": {
    "title": "MiniMax Voice Cloning API",
    "description": "MiniMax Voice Cloning API with support for voice cloning and file upload",
    "license": {
      "name": "MIT"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.minimax.cn"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/files/upload": {
      "post": {
        "summary": "Upload File",
        "operationId": "uploadFile",
        "tags": ["Files"],
        "parameters": [
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "description": "请求体的媒介类型 `multipart/form-data` ",
            "schema": {
              "type": "string",
              "enum": ["multipart/form-data"],
              "default": "multipart/form-datan"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": ["purpose", "file"],
                "properties": {
                  "purpose": {
                    "type": "string",
                    "description": "文件使用目的。取值及支持格式如下：\n- `voice_clone`: 快速复刻原始文件，（支持mp3、m4a、wav格式）",
                    "default": "voice_clone",
                    "enum": ["voice_clone"],
                    "example": "voice_clone"
                  },
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "需要上传的文件。填写文件的路径地址 \n\n支持上传的文件需遵从以下规范：\n- 上传的音频文件格式需为：mp3、m4a、wav格式\n- 上传的音频文件的时长最少应不低于10秒，最长应不超过5分钟\n- 上传的音频文件大小需不超过20mb"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadFileResp"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "UploadFileResp": {
        "type": "object",
        "properties": {
          "file": {
            "$ref": "#/components/schemas/FileObject"
          },
          "base_resp": {
            "$ref": "#/components/schemas/UploadFileBaseResp"
          }
        },
        "example": {
          "file": {
            "file_id": "${file_id}",
            "bytes": 5896337,
            "created_at": 1700469398,
            "filename": "复刻音频",
            "purpose": "voice_clone"
          },
          "base_resp": {
            "status_code": 0,
            "status_msg": "success"
          }
        }
      },
      "FileObject": {
        "type": "object",
        "properties": {
          "file_id": {
            "type": "integer",
            "format": "int64",
            "description": "文件的唯一标识符"
          },
          "bytes": {
            "type": "integer",
            "format": "int64",
            "description": "文件大小，以字节为单位"
          },
          "created_at": {
            "type": "integer",
            "format": "int64",
            "description": "创建文件时的 Unix 时间戳，以秒为单位"
          },
          "filename": {
            "type": "string",
            "description": "文件的名称"
          },
          "purpose": {
            "type": "string",
            "description": "文件的使用目的",
            "enum": ["voice_clone"]
          }
        }
      },
      "UploadFileBaseResp": {
        "type": "object",
        "properties": {
          "status_code": {
            "type": "integer",
            "description": "状态码及其分别含义如下：\n- 0，请求成功\n- 1002，触发限流，请稍后再试\n- 1004，账号鉴权失败，请检查 API-Key 是否填写正确\n- 1008，账号余额不足\n- 1026，图片描述涉及敏感内容\n- 2013，传入参数异常，请检查入参是否按要求填写\n- 2049，无效的api key\n\n更多内容可查看错误码查询列表了解详情"
          },
          "status_msg": {
            "type": "string",
            "description": "状态详情"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "`HTTP: Bearer Auth`\n - Security Scheme Type: http\n - HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在 [账户管理>接口密钥](https://platform.minimax.cn/user-center/basic-information/interface-key) 中查看。"
      }
    }
  }
}