列出音效模型

GET 
https://api.knoxstudio.ai/v1/sound-generation/models

返回音效模型。将 id 用作 model_id。默认 eleven_text_to_sound_v2。见 音效生成。

认证是可选的（公开目录每分钟 60 次，缓存 5 分钟；携带 token 时过滤列表）。

请求

此端点不需要请求参数。

请求头

名称	类型	必填	描述
Authorization	String	否	可选 Bearer <token>。省略则返回公开目录。也接受 xi-api-key。

cURL 示例

curl -X GET https://api.knoxstudio.ai/v1/sound-generation/models

响应

成功响应 (200)

{
  "data": [
    {
      "id": "eleven_text_to_sound_v2",
      "max_duration_seconds": 30,
      "pricing": { "per_minute": "0.17" }
    }
  ]
}

响应 Schema

名称	类型	描述
data[].id	string	用作 model_id。
data[].max_duration_seconds	integer	30。
data[].pricing.per_minute	string	每生成分钟美元价格（0.17）。

错误响应

校验失败使用 HTTP 422：

{
  "detail": [
    {
      "loc": ["body", "field"],
      "msg": "…",
      "type": "value_error"
    }
  ]
}

其他错误使用 { "detail": "message" }。

状态	何时
400	未升级 WebSocket 就访问 WebSocket 端点。
401	缺少或无效的 API key。
402	余额不足。
403	Token 无权使用该模型。
404	资源未找到。
422	校验错误。
429	超出速率限制。
500	服务器内部错误。