Api
音频生成 API
通过 POST /api/v1/speech 与 POST /api/v1/sound-effects 实现文本转语音和音效生成。
音频为同步生成：响应通常已带 status: "success"，结果 URL 在 data.taskUrls 中。返回的 data.id 同样可用于 GET /api/v1/tasks/{taskId} 以保持统一的轮询流程。
列出音色
GET /api/v1/voices 返回可用的文本转语音音色和每次生成的积分成本，无需请求体。
curl -H "Authorization: Bearer $VIDRUSH_API_KEY" \
https://vidrush-ai.com/api/v1/voices每个音色包含 id、name、gender、accent、language 和 recommended_model。创建语音时用音色的 id 作为 voice_id。
文本转语音
POST /api/v1/speech 用所选音色将文本转为语音。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
text | 是 | string | 非空的待朗读文本 |
voice_id | 是 | string | 来自 GET /api/v1/voices 的音色 id |
options | 否 | object | model_id、speed（0.25–4）、stability（0–1）、similarity_boost（0–1） |
curl -X POST https://vidrush-ai.com/api/v1/speech \
-H "Authorization: Bearer $VIDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Welcome to Vidrush.",
"voice_id": "EXAVITQu4vr4xnSDxMaL",
"options": { "speed": 1.0 }
}'音效
POST /api/v1/sound-effects 根据文本提示生成音效。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
prompt | 是 | string | 非空的声音描述 |
options | 否 | object | duration_seconds（0.5–22）、prompt_influence（0–1） |
curl -X POST https://vidrush-ai.com/api/v1/sound-effects \
-H "Authorization: Bearer $VIDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "prompt": "A distant rolling thunder clap", "options": { "duration_seconds": 5 } }'成功响应
{
"code": 0,
"message": "ok",
"data": {
"id": "task_123",
"status": "success",
"costCredits": 1,
"taskUrls": ["https://.../audio.mp3"]
}
}