音乐作品与资产 - APIstable

当前为 API 预览。生成接口尚未接入供应商，成功认证后仍可能返回 503；不会创建任务或扣积分。

按作品理解结果，不按 URL 数量

音乐供应商可能在一次原生生成中返回多个作品。一部作品可以包含音频、封面、歌词与元数据；这些资产是作品的组成，不是独立生成次数。模型页面与计价规则必须说明供应商原生组合。一次任务返回两首音乐，不能记为两次用户 API 调用。

{
  "works": [
    {
      "work_id": "work_example",
      "title": "Evening light",
      "assets": [
        {
          "type": "audio",
          "url": "https://media.example.com/audio.mp3"
        },
        {
          "type": "cover",
          "url": "https://media.example.com/cover.webp"
        },
        {
          "type": "lyrics",
          "text": "Illustrative lyric content"
        }
      ]
    }
  ]
}

这是概念预览，不是真实生成结果；具体输出字段在各模型接入前锁定。

不自动套用 output_count

新增 1–4 的 output_count 仅用于图片与视频，不倍增音乐原生组合。音乐续写、歌词生成和歌曲生成使用不同操作 ID 与规则。

部分作品与交付

每个作品状态、资产可用性和任务计费状态需独立表达。缺少封面不能静默触发整次音乐重新生成；文件转存失败只重试资产获取。原生多作品任务的部分成功计费按模型定义，必须在该模型开放收费前发布。