Minimax Tts

能力概述

基于 MiniMax T2A V2 接口，将文本同步合成为语音音频。支持中文、英文、日文等多种语言，提供系统音色与自定义音色，可控制语速、音量、语调、情绪等参数，还支持停顿标记、语气词标签、发音字典、LaTeX 朗读、混合音色、声音效果器等高级特性。

平台差异说明

详细参数表、Edge Function 代码、前端代码见 references/t2a-v2-api.md

生成期用法（Agent 直接调用）

直接在 Deno 脚本中调用 MiniMax T2A V2 接口，使用平台注入的密钥。

const apiKey = process.env["INTEGRATIONS_API_KEY"]!; // platform_managed 密钥由平台注入

async function callMinimaxTTS(
  text: string,
  voiceId: string = "male-qn-qingse",
  model: string = "speech-02-turbo",
  outputFormat: "url" | "hex" = "url",
): Promise<{ audioUrl: string; audioLength: number; usageCharacters: number }> {
  const response = await fetch("https://app-bo4w33bsdqm9-api-DLEO7Bj0lORa-gateway.appmiaoda.com/v1/t2a_v2", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Gateway-Authorization": `Bearer ${apiKey}`,
    },
    body: JSON.stringify({
      model,
      text,
      stream: false,
      output_format: outputFormat,
      voice_setting: { voice_id: voiceId, speed: 1, vol: 1 },
      audio_setting: { format: "mp3" },
    }),
  });

  if (!response.ok) throw new Error(`HTTP error: ${response.status}`);

  const json = await response.json();
  if (json.base_resp?.status_code !== 0) {
    throw new Error(`API error ${json.base_resp?.status_code}: ${json.base_resp?.status_msg}`);
  }

  return {
    audioUrl: json.data.audio,                        // CDN URL（output_format: "url" 时）
    audioLength: json.extra_info?.audio_length ?? 0,
    usageCharacters: json.extra_info?.usage_characters ?? 0,
  };
}

完整参数列表、高级用法（混合音色、声音效果器、发音字典等）见 references/t2a-v2-api.md

生成后用法（应用内通过 Edge Function 调用）

在应用中通过 Supabase Edge Function 调用 MiniMax TTS，平台密钥由 Edge Function 注入，客户端不接触原始 API Key。

Web 与 MiniProgram 实现存在差异，请根据目标平台选择对应的 Edge Function 和前端代码：

完整 Edge Function 代码、Web 前端代码、MiniProgram 前端代码见 references/t2a-v2-api.md