众扬汇 AI 开放平台 API 文档

上传示例音频

OpenAPI Specification

示例音频上传:上传用于增强音色相似度与稳定性的示例音频。

请求方式:POST

接口地址

text
https://api.allyang.cn/minimax/v1/files/upload

请求头

  • Authorization(可选):鉴权头,使用控制台创建的令牌,格式为 Bearer + 令牌。(示例:Bearer {{YOUR_API_KEY}})

请求参数(multipart/form-data)

  • purpose(string,必填):文件用途。取值 prompt_audio(快速复刻原始文件,支持 mp3、m4a、wav)。示例:"prompt_audio"。
  • file(string,必填):待上传文件,填写文件路径;要求格式 mp3、m4a、wav,时长小于 8 秒,大小不超过 20MB。

返回字段

  • file(object,可选)
    • file_id(integer,可选):文件唯一标识符。
    • bytes(integer,可选):文件大小(字节)。
    • created_at(integer,可选):创建文件的 Unix 时间戳(秒)。
    • filename(string,可选):文件名。
    • purpose(string,可选):文件用途。
  • base_resp(object,可选)
    • status_code(integer,可选):状态码及含义:0 请求成功;1002 触发限流,请稍后重试;1004 账号鉴权失败,请检查 API-Key;1008 账号余额不足;1026 图片描述涉及敏感内容;2013 入参异常,请检查参数填写;2049 API Key 无效。
    • status_msg(string,可选):状态详情。

使用提示:文件格式、时长与大小要求见参数说明。