Api
音乐生成 API
通过 POST /api/v1/music 创建音乐生成任务。
创建音乐任务
POST /api/v1/music 根据文本提示生成原创音乐，被接受时消耗积分。
POST https://vidrush-ai.com/api/v1/music
Authorization: Bearer sk-your-api-key
Content-Type: application/json音乐为同步生成：响应通常已带 status: "success"，结果 URL 在 data.taskUrls 中。若偏好统一的轮询流程，返回的 data.id 同样可用于 GET /api/v1/tasks/{taskId}。
请求体
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
prompt | 是 | string | 非空的曲目描述 |
options | 否 | object | 生成控制项 |
options
| 字段 | 类型 | 说明 |
|---|---|---|
duration_seconds | number | 目标时长，3–300 |
instrumental | boolean | true 表示纯音乐无人声 |
style | string | 可选的风格/流派提示 |
lyrics | string | 可选歌词 |
调用 GET /api/v1/models?type=music 获取当前模型目录和积分成本。
示例
curl -X POST https://vidrush-ai.com/api/v1/music \
-H "Authorization: Bearer $VIDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Warm lo-fi hip-hop with a mellow piano loop",
"options": { "duration_seconds": 30, "instrumental": true }
}'成功响应
{
"code": 0,
"message": "ok",
"data": {
"id": "task_123",
"status": "success",
"costCredits": 10,
"taskUrls": ["https://.../music.mp3"]
}
}