查找模型对应的播报示例

GET /v1/audio/speech/examples

返回按模型区分的播报示例，并标明适用性。先在不加筛选的清单里找到有效的 ID 和模式，筛选值无效会返回 400。每条示例都带 applicable 和 reason；只用所选模型支持其控制项的示例。

指南与示例播报与声音库全部接口

参数

modelstring按模型筛选。

modestring按模式筛选，例如 voice-design。

languagestring按语言筛选，例如 en-US。

idstring按示例 ID 筛选。

recipestring按 recipe 筛选。

响应

200示例清单。

schema_versionstring

catalog_versionstring

verified_atstring

resolved_languagestring

modelsobject[]

examplesobject[]

modelstring

modestring例如 emotion-vector、style-control 或 voice-design。

languagestring

idstring

recipestring

applicableboolean

reasonstring | null

{
  "schema_version": "1",
  "catalog_version": "2026-09-01",
  "verified_at": "2026-09-01T00:00:00Z",
  "resolved_language": "en-US",
  "models": [
    {
      "id": "openbmb/VoxCPM2"
    }
  ],
  "examples": [
    {
      "model": "openbmb/VoxCPM2",
      "mode": "voice-design",
      "language": "en-US",
      "applicable": true,
      "reason": null
    }
  ]
}

400请求不合法。先改请求再重试：error.code 用于程序判断，error.param 用于定位是哪个输入。

401API Key 缺失或无效。

403Host 或 Origin 不被允许，或 License 被拒。按 error.code 区分这两种情况。

503所需的本地模型仍在准备（model_downloading），或服务正忙（service_busy）。带 Retry-After 时按它退避。