音色快速复刻
OpenAPI Specification
yaml
openapi: 3.0.1
info:
title: ''
description: "本页接口说明详见下方接口定义;参数取值与返回以本平台实测为准。"
version: 1.0.0
paths:
/minimax/v1/voice_clone:
post:
summary: 音色快速复刻
deprecated: false
description: "使用本接口进行音色快速复刻;复刻得到的音色若 7 天内未正式调用,系统将删除该音色。上游文档外链已移除,参数与返回以本平台实测为准。"
tags:
- 音频接口/MINIMAX 语音合成
parameters:
- name: Authorization
in: header
description: "该字段的取值与含义以本平台实际返回为准。"
required: false
example: Bearer {{YOUR_API_KEY}}
schema:
type: string
default: Bearer {{YOUR_API_KEY}}
requestBody:
content:
application/json:
schema:
type: object
properties:
file_id:
type: integer
voice_id:
type: string
clone_prompt:
type: object
properties:
prompt_audio:
type: integer
prompt_text:
type: string
required:
- prompt_audio
- prompt_text
text:
type: string
model:
type: string
need_noise_reduction:
type: boolean
need_volume_normalization:
type: boolean
aigc_watermark:
type: boolean
required:
- file_id
- voice_id
example:
file_id: 123456789
voice_id: <voice_id>
clone_prompt:
prompt_audio: 987654321
prompt_text: This voice sounds natural and pleasant.
text: >-
A gentle breeze sweeps across the soft grass(breath), carrying
the fresh scent along with the songs of birds.
model: speech-2.8-hd
need_noise_reduction: false
need_volume_normalization: false
aigc_watermark: false
responses:
'200':
description: "该字段的取值与含义以本平台实际返回为准。"
content:
application/json:
schema:
type: object
properties:
file:
type: object
properties:
file_id:
type: integer
description: "文件唯一标识"
bytes:
type: integer
description: "文件大小,单位字节"
created_at:
type: integer
description: "文件创建时间,Unix 时间戳,单位秒"
filename:
type: string
description: "文件名"
purpose:
type: string
description: "文件用途"
base_resp:
type: object
properties:
status_code:
type: integer
description: "状态码及含义:0 请求成功、1002 触发限流(请稍后重试)、1004 账号鉴权失败(请检查 API Key)、1008 账号余额不足、1026 图片描述涉及敏感内容、2013 传入参数异常(请检查入参)、2049 无效的 API Key。"
status_msg:
type: string
description: "本次任务的状态详情"
headers: {}
security: []
components:
schemas: {}
securitySchemes: {}
servers: []
security: []
使用提示:本页接口的 Base URL 为
https://api.allyang.cn,请求头需携带Authorization: Bearer <令牌>(令牌在控制台「令牌管理」中创建)。示例中的任务 ID、时间戳与文件地址均为示意值,实际以平台返回为准。模型名请在「模型广场」复制后填入,不要手输;计费、限流与在售清单以平台实测为准(部分数值待补)。