获取 API Key 获取 API
文档

音效生成

- 根据描述生成音效。

  • 异步任务:提交返回 task_id,轮询 GET /v1/music/tasks/:task_id 获取结果

请求示例

curl -X POST https://api.openveer.com/v1/music/generations/sounds \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "prompt": "雷雨与远处的钟声"
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

所有接口均需要使用Bearer Token进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Body

model string

音频模型。当前传 suno(不传默认 suno)。

version string

生成版本:仅 v5 / v5.5,不传默认 v5.5。

prompt string

音效文本描述;缺失时提交期直接返回 400(不扣费)。建议尽量使用英文提示词,效果更佳。

type string

音效类型:one-shot(默认,单次)/ loop(可循环)。

bpm integer

速度,1–300;超出范围提交期直接返回 400。

key string

调性枚举:大调 C / C# / D / D# / E / F / F# / G / G# / A / A# / B;小调在后面加 m(Cm / C#m / … / Bm)。仅支持升号(#)写法,降号(Db / Eb 等)与 B# 会返回 400(key param error)。

注意

获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 status 为 completed 或 failed(生成中为 pending,progress 排队 10 → 就绪 50 → 完成 100)。完成后在 data.result.music[] 取 audio_url。失败时 data.error.message 为原因,自动退回预扣额度。

Response

code integer

响应状态码

data array
返回数据数组
status string

任务状态

  * submitted - 已提交
task_id string

任务唯一标识符(用于轮询 GET /v1/music/tasks/{task_id} 获取结果)