> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmax.com/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax 预设音色清单 ## OpenAPI ````yaml openapi/zh/configs-minimax-preset-voice-id.json GET /v1/configs/minimax-preset-voice-id openapi: 3.1.0 info: title: MiniMax 预设音色清单 version: '1.0' servers: - url: https://api.aihubmax.com security: - BearerAuth: [] paths: /v1/configs/minimax-preset-voice-id: get: tags: - Config Query summary: 查询 MiniMax 预设音色清单 operationId: configs-minimax-preset-voice-id parameters: - name: language in: query required: false schema: type: string enum: - zh - en default: zh example: zh description: >- 返回数据的语言版本：`zh`（中文，默认）/ `en`（英文）。两种版本的 `voice_id` 完全一致，仅 `voice_name` / `language` / `accent` / `gender` / `age` / `tag_list` / `description` 文案随语言切换。 responses: '200': description: 查询成功，返回预设音色数组 content: application/json: schema: type: array items: $ref: '#/components/schemas/MinimaxVoicePreset' examples: zh_sample: summary: 中文版本（节选 2 条） value: - id: '298735722549316' voice_id: Afrikaans_female_1_v1 voice_name: Outgoing Girl language: 阿非利卡语 accent: 标准口音 gender: 女 age: 青年 tag_list: - 广告与预告 - 播客与社媒 - 企业宣传与旁白 - 明亮清脆 - 语速轻快 - 电台主播感 cover_url: >- https://cdn.hailuoai.video/moss/staging/2024-11-21-14/moss-audio/voice_cover//1732170987980918894-207331589840977.png?x-oss-process=image/resize,p_50/format,webp sample_audio: >- https://filecdn.minimax.chat/public/6579ac88-28ed-46a4-b930-eed7602faa1d.mp3 description: >- 这是一个充满活力的青年女声。其声线明亮清脆且极具穿透力，说话节奏语速轻快、干脆利落。整体风格热情洋溢且具有极强的感染力，自带一种专业的电台主播感，非常适合用于商业广告、社交媒体短视频或快节奏的广播节目等场景。 - id: '295' voice_id: Arabic_CalmWoman voice_name: Calm Woman language: 阿拉伯语 accent: '' gender: 女 age: 中年 tag_list: [] cover_url: '' sample_audio: >- https://ftres.oss-cn-beijing.aliyuncs.com/aitools/voices/Arabic_CalmWoman_audio.mp3 description: '' en_sample: summary: 英文版本（节选 2 条） value: - id: '298712934264945' voice_id: Afrikaans_female_1_v1 voice_name: Outgoing Girl language: Afrikaans accent: Standard gender: Female age: Young tag_list: - Commercials & Trailers - Podcasts & Social - Corporate & Narration - Bright - Crisp - Resonant cover_url: >- https://ftapp.oss-cn-beijing.aliyuncs.com/aitools/voices/Afrikaans_female_1_v1_cover.png sample_audio: >- https://ftapp.oss-cn-beijing.aliyuncs.com/aitools/voices/Afrikaans_female_1_v1_audio.mp3 description: >- Bright, clean, and strongly projected, with a fast, rhythmic delivery that feels broadcast-ready. Best for news updates, community announcements, station imaging, and promo reads that need an energetic, articulate host sound. - id: '295' voice_id: Arabic_CalmWoman voice_name: Calm Woman language: Arabic accent: '' gender: Female age: Middle-aged tag_list: [] cover_url: '' sample_audio: >- https://ftres.oss-cn-beijing.aliyuncs.com/aitools/voices/Arabic_CalmWoman_audio.mp3 description: '' '400': description: language 参数无效 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: message: 'Unsupported language ''fr''. Allowed: [''en'', ''zh'']' type: invalid_request_error code: invalid_language '401': $ref: '#/components/responses/Unauthorized' '404': description: config key 未注册 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: message: >- Unknown config key 'xxx'. Available keys: ['minimax-preset-voice-id'] type: invalid_request_error code: config_not_found components: schemas: MinimaxVoicePreset: type: object description: 单条 MiniMax 预设音色记录 required: - id - voice_id - voice_name properties: id: type: string description: 音色内部数据库 ID（数字串），仅用于内部追溯，**不要**填入语音合成请求 example: '295' voice_id: type: string description: 音色 ID。**这是直接填入语音合成请求 `voice_setting.voice_id` 字段的值。** example: Arabic_CalmWoman voice_name: type: string description: 音色展示名称（按 `language` 切换中英文） example: Calm Woman language: type: string description: >- 音色所属语种（按 `language` 切换中英文，如 `Arabic` / `阿拉伯语`、`Chinese (Mandarin)` / `中文-普通话`） example: Arabic accent: type: string description: 口音标签（按 `language` 切换中英文，如 `Standard` / `标准口音`）。部分新版条目为空字符串。 example: Standard gender: type: string description: >- 性别（按 `language` 切换中英文，如 `Male` / `Female` / `Character` 或 `男` / `女` / `角色`） example: Female age: type: string description: >- 年龄段（按 `language` 切换中英文，如 `Young` / `Middle-aged` / `Elderly` / `Child` 或 `青年` / `中年` / `老年` / `儿童`）。部分新版条目为空字符串。 example: Middle-aged tag_list: type: array items: type: string description: 风格/场景标签列表（按 `language` 切换中英文）。部分新版条目为空数组。 cover_url: type: string description: 封面图片 URL。部分新版条目为空字符串。 sample_audio: type: string description: 样本音频 URL（建议直接试听挑选） description: type: string description: 音色文字描述（按 `language` 切换中英文）。部分新版条目为空字符串。 ErrorResponse: type: object properties: error: type: object properties: message: type: string type: type: string code: type: string ErrorResponse401: type: object properties: error: type: object properties: message: type: string example: API密钥无效 type: type: string example: authentication_error responses: Unauthorized: description: 未授权 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse401' securitySchemes: BearerAuth: type: http scheme: bearer description: | ## 所有接口均需要使用Bearer Token进行认证 ## 使用时在请求头中添加： `Authorization: Bearer YOUR_API_KEY` ````