获取 API Key 获取 API
文档

续写延长

- 在已有歌曲的某个时间点之后续写延长。

  • 引用源音轨:task_id + audio_index 指定,无需记录任何额外 id
  • 异步任务:提交返回 task_id,轮询 GET /v1/music/tasks/:task_id 获取结果
信息

引用源音轨:基于已有歌曲的操作无需记任何额外 id,只需传 task_id(产出源音轨那次任务的 task_id)+ audio_index(结果 music[] 里第几首,1-based,默认 1)。

注意

extend 的 custom 不强制、也不做推断——传就透传,不传也能正常续写。custom=true 时按 prompt(歌词)续写;custom=false 或不传时可用 gpt_description(灵感描述)引导续写方向。

请求示例

curl -X POST https://api.openveer.com/v1/music/generations/extend \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "task_id": "task_01ABC",
    "audio_index": 1,
    "continue_at": 120,
    "version": "v5",
    "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)。

task_id string

产出源音轨那次任务的 task_id;缺失或无法解析源时提交期直接返回 400。

audio_index integer

引用源任务结果 data.music[] 中的第几首(1-based;默认 1;一次生成通常 2 首:索引 1 与 2)。

continue_at integer

从第几秒开始续写。

version string

生成版本:v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5,影响音质与计费;不传默认 v5.5,非法值提交期直接返回 400。

custom boolean

不传即可(extend 不强制)。true=按 prompt 歌词续写;false=灵感续写。

prompt string

续写歌词,custom=true 时生效。

gpt_description string

灵感提示词,custom=false/不传时生效(引导续写方向)。

title string

标题。仅 custom=true 时生效。

tags string

风格标签。仅 custom=true 时生效。

negative_tags string

排除的风格标签。仅 custom=true 时生效。

vocal_gender string

人声性别:Male / Female。两种模式均生效。

style_weight number

风格权重,0.00–1.00(超出范围提交期直接返回 400)。仅 custom=true 时生效。

weirdness_constraint number

创意度权重,0.00–1.00(别名 weirdness)。仅 custom=true 时生效。

audio_weight number

音频权重,0.00–1.00。仅 custom=true 时生效。

auto_lyrics boolean

true=对输入歌词进行二次创作。仅 custom=true 时生效。

persona_id string

Persona 风格 id。仅 custom=true 时生效。

注意

获取结果:本接口为异步任务。提交后拿到 task_id,按 3–5s 间隔轮询 GET /v1/music/tasks/{task_id},直到 status 为 completed 或 failed(音乐生成通常 30–120s;生成中为 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} 获取结果)