POST /audio/v1/generations 的请求体使用统一结构。
统一请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型代码，来自音频模型目录。 |
prompt | string | 是 | 待合成或生成的文本，不能为空。 |
voice | string | 否 | 音色或说话人标识；具体值由模型决定。 |
stream | boolean | 是 | 是否使用 SSE 流式响应。 |
task | boolean | 是 | 是否创建异步任务。 |
upstream_options | object | 否 | 供应商或模型特有参数。 |
stream 和 task 不能同时为 true。
upstream_options
必须是 JSON 对象，不能是数组或 null。用于传递供应商或模型的私有参数。
{
"upstream_options": {
"unique_id": "your-business-request-id"
}
}
异步任务支持使用 upstream_options.unique_id 做业务幂等标识。
请求追踪请求头
| 请求头 | 说明 |
|---|---|
x-trace-id | 业务追踪 ID，写入任务和用量记录。 |
x-user-id | 业务侧终端用户 ID。 |
x-agent-name | 调用方 Agent 或服务名称。 |
示例：
curl -X POST https://51kik.com/audio/v1/generations \
-H 'Authorization: Bearer sk-xxxxxxxx' \
-H 'Content-Type: application/json' \
-H 'x-trace-id: audio-demo-001' \
-H 'x-user-id: user-42' \
-H 'x-agent-name: voice-worker' \
-d '{"model": "<audio-model>", "prompt": "一段语音文本。", "stream": false, "task": false}'
Body 大小限制
请求体上限为 50 MB。