创建音色
以音频样本创建/克隆新音色。该接口仅支持 multipart/form-data，参考音频用 audio_sample 文件字段提供。当前 /v1 未注册 GET /v1/audio/voices/{voice_id}。
POST
认证
在请求头中加入 Authorization: Bearer <API_KEY> 完成鉴权，密钥可在控制台「API 密钥」页生成。
curl https://api.mosi.cn/v1/audio/voices \
-H "Authorization: Bearer $MOSS_API_KEY"
请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| audio_sample | multipart file | 是 | 参考音频文件；仅 multipart 支持该字段。 |
| name | string | 否 | 音色名称。 |
| description | string | 否 | 音色描述。 |
请求示例
curl -X POST https://api.mosi.cn/v1/audio/voices \
-H "Authorization: Bearer $MOSS_API_KEY" \
-F audio_sample=@sample.wav \
-F name=Alice
响应字段
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
| id | string | 是 | voice id； |
| object | string | 是 | 固定为 |
| name | string | 是 | 音色名称；未传 |
| created_at | integer | 是 | 创建时间，Unix 时间戳，单位为秒。 |
响应示例
{
"id": "<voice_id>",
"object": "audio.voice",
"name": "Alice",
"created_at": 1710000000
}