Azure AI Speech REST API 参考

该接口的官方文档在微软Azure AI Speech的REST API参考中，以下是完整的官方文档入口与核心信息，便于你快速查阅与调用。

官方文档入口

接口核心信息（快速查阅）

项 详情
请求方法 GET
完整 URL https://{region}.tts.speech.microsoft.com/cognitiveservices/voices/list
认证方式 二选一：
1. Ocp‑Apim‑Subscription‑Key: {你的密钥}
2. Authorization: Bearer {令牌}
响应格式 JSON 数组
状态码 200 OK（成功）
区域约束 预览音色仅在 East US/West Europe/Southeast Asia 可用

请求示例（CURL）

curl -X GET "https://eastus.tts.speech.microsoft.com/cognitiveservices/voices/list" \
     -H "Ocp-Apim-Subscription-Key: YOUR_RESOURCE_KEY"

请求示例（PHP）

<?php
/**
 * 获取微软TTS（Azure Text-to-Speech）音色列表
 * 直接返回原始JSON数据，便于程序调用
 * 前置条件：需要先在Azure控制台创建Speech服务，获取API密钥和区域
 */

// 配置你的Azure Speech服务信息（必填）
$azureKey = "你的Azure Speech API密钥"; // 替换为实际密钥
$azureRegion = "你的服务区域"; // 例如：eastus、southeastasia、westeurope等

// 微软TTS获取语音列表的API地址
$apiUrl = "https://$azureRegion.tts.speech.microsoft.com/cognitiveservices/voices/list";

// 设置响应头为JSON格式（核心修改）
header("Content-Type: application/json; charset=utf-8");

// 初始化cURL请求
$ch = curl_init();

// 设置cURL选项
curl_setopt_array($ch, [
    CURLOPT_URL => $apiUrl,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Ocp-Apim-Subscription-Key: $azureKey",
        "Content-Type: application/json"
    ],
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_TIMEOUT => 30
]);

// 执行请求并获取响应
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);

// 关闭cURL资源
curl_close($ch);

// 处理响应结果（返回JSON格式的错误或原始数据）
$result = [];
if ($error) {
    // cURL请求错误
    http_response_code(500);
    $result = [
        "code" => 500,
        "msg" => "请求失败：" . $error,
        "data" => null
    ];
} elseif ($httpCode !== 200) {
    // API返回非200状态码
    http_response_code($httpCode);
    $result = [
        "code" => $httpCode,
        "msg" => "API请求失败",
        "data" => $response
    ];
} else {
    // 直接返回原始响应（已为JSON格式）
    echo $response;
    exit; // 直接输出原始数据后终止脚本
}

// 输出错误信息的JSON
echo json_encode($result, JSON_UNESCAPED_UNICODE);
?>

 

响应示例（JSON 片段）

[
  {
    "Name": "Microsoft Server Speech Text to Speech Voice (zh-CN, XiaoxiaoNeural)",
    "ShortName": "zh-CN-XiaoxiaoNeural",
    "Gender": "Female",
    "Locale": "zh-CN",
    "SampleRateHertz": "24000",
    "VoiceType": "Neural",
    "Status": "GA"
  }
]

关键字段说明

字段 用途
ShortName 调用 TTS 合成时的语音标识（必填）
Locale 语言/地区代码（如 zh-CN、en-US）
Gender 性别（Male/Female）
VoiceType 类型（Neural/Standard）
Status 发布状态（GA/Preview）

常见问题

  1. 401 错误：检查密钥与区域是否匹配，密钥是否未过期。
  2. 403 错误：确认 Speech 资源已启用，且未超出配额。
  3. 预览音色：仅在 East US/West Europe/Southeast Asia 区域返回预览音色。
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。