> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apistable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 音乐作品与资产

> 一个生成作品可以包含音频、封面与歌词。

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

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

音乐供应商可能在一次原生生成中返回多个作品。一部作品可以包含音频、封面、歌词与元数据；这些资产是作品的组成，不是独立生成次数。

模型页面与计价规则必须说明供应商原生组合。一次任务返回两首音乐，不能记为两次用户 API 调用。

```bash theme={null}
{
  "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 与规则。

## 部分作品与交付

每个作品状态、资产可用性和任务计费状态需独立表达。缺少封面不能静默触发整次音乐重新生成；文件转存失败只重试资产获取。

原生多作品任务的部分成功计费按模型定义，必须在该模型开放收费前发布。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.