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

# 音乐生成介绍

> 歌词与歌曲一体化生成能力概览

export const PlatformLink = ({href, children}) => {
  const MOBILE_MAX_WIDTH = 768;
  const TOAST_TEXT = '为了更好的支付体验，请在电脑端进行操作';
  const TOAST_DURATION_MS = 2400;
  const [toastVisible, setToastVisible] = useState(false);
  const hideTimerRef = useRef(0);
  useEffect(() => {
    return () => {
      if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
    };
  }, []);
  const handleClick = event => {
    const isMobile = typeof window !== 'undefined' && window.matchMedia(`(max-width: ${MOBILE_MAX_WIDTH - 1}px)`).matches;
    if (!isMobile) return;
    event.preventDefault();
    event.stopPropagation();
    setToastVisible(true);
    if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
    hideTimerRef.current = window.setTimeout(() => {
      setToastVisible(false);
    }, TOAST_DURATION_MS);
  };
  return <>
      <a href={href} onClick={handleClick} target="_blank" rel="noreferrer" className="text-primary">
        {children}
      </a>
      {toastVisible && <div role="status" aria-live="polite" className="fixed left-1/2 bottom-20 -translate-x-1/2 max-w-[calc(100vw-32px)] px-5 py-3 bg-black/85 text-white text-sm leading-normal rounded-lg shadow-lg z-[99999] text-center pointer-events-none">
          {TOAST_TEXT}
        </div>}
    </>;
};

SenseAudio 音乐生成服务面向歌词创作、歌曲生成、BGM 制作与内容配乐等场景，提供统一的音乐生成 API。开发者既可以先生成歌词，再生成歌曲，也可以直接基于提示词或结构化歌词创建完整音乐作品。

## 什么是音乐生成

音乐生成能力将歌词创作与歌曲生成打通为一条完整链路，适合从灵感草稿到成品音频的自动化工作流。

**核心能力**：

* **歌词生成**：根据给定的提示词快速生成结构化歌词内容
* **歌曲生成**：根据歌词或提示词生成完整歌曲
* **风格控制**：支持设置风格、负面标签、纯音乐、人声性别等参数
* **异步任务处理**：歌曲生成采用任务制，适合耗时较长的生成场景

## 主要特性

* **歌词与歌曲一体化**：先用歌词生成接口产出灵感草稿，再将结果直接交给歌曲生成接口完成成品制作。
* **结构化歌词输入**：歌曲接口支持 `[verse]`、`[chorus]`、`[bridge]` 等结构标签，便于对歌曲段落进行显式控制。
* **提示词与纯音乐模式**：除了标准歌词模式外，还支持直接基于提示词生成完整音乐，以及纯音乐模式，适合配乐、氛围音乐与 demo 创作。
* **任务式结果获取**：歌曲创建接口返回 `task_id`，可通过轮询接口获取生成状态和最终音频地址，便于接入任务中心或后台流程。

## 模型版本

当前音乐生成相关模块统一使用以下模型：

* `senseaudio-music-1.0-260319`

## API 能力概览

SenseAudio 音乐生成提供以下核心 API 接口：

### 1. 创建歌词生成任务

根据提示词生成歌词内容，适合灵感扩写、歌词草稿生成和创作辅助。

* 文档：**[创建歌词生成任务](/api-reference/endpoint/music/lyrics-create)**
* 接口地址：`POST https://api.senseaudio.cn/v1/music/lyrics/create`

### 2. 创建歌曲生成任务

根据歌词或提示词生成歌曲，支持配置音乐风格、人声性别，以及是否为纯音乐等参数。

* 文档：**[创建歌曲生成任务](/api-reference/endpoint/music/song-create)**
* 接口地址：`POST https://api.senseaudio.cn/v1/music/song/create`

### 3. 查询歌曲生成状态

根据 `task_id` 查询歌曲生成进度，并在成功后获取音频、封面和歌词结果。

* 文档：**[查询歌曲生成状态](/api-reference/endpoint/music/song-pending)**
* 接口地址：`GET https://api.senseaudio.cn/v1/music/song/pending/{task_id}`

## 参数选择建议

| 场景        | 推荐接口                | 说明                     |
| :-------- | :------------------ | :--------------------- |
| 歌词创意辅助    | 创建歌词生成任务            | 适合灵感发散和歌词草稿生成          |
| 直接生成完整歌曲  | 创建歌曲生成任务            | 适合快速出 demo 或完整音乐       |
| 生成纯音乐/BGM | 创建歌曲生成任务            | 配合 `instrumental` 参数使用 |
| 后台任务管理    | 创建歌曲生成任务 + 查询歌曲生成状态 | 适合异步工作流和任务中心           |

## 计费说明

请参考 **[计费规则](/guides/account/billing)**。

## 典型应用场景

### 短视频与自媒体配乐

快速生成适合视频节奏和情绪的歌曲或背景音乐，降低内容制作门槛。

### 品牌营销与活动主题曲

为品牌活动、宣传片或产品发布会快速生成定制化音乐素材。

### 创作辅助与灵感验证

帮助音乐创作者、策划和编剧快速验证旋律走向、音乐氛围与歌词方向，提升前期创作效率。

## 开始使用

<Steps>
  <Step title="获取 API Key">
    前往 [API 密钥](https://senseaudio.cn/api-platform/api-key) 创建您的 API Key。
  </Step>

  <Step title="生成歌词草稿">
    输入创作意图，调用 [创建歌词生成任务](/api-reference/endpoint/music/lyrics-create) 获取灵感草稿；可对歌词进行筛选或微调，确认最终文本。
  </Step>

  <Step title="创建歌曲任务">
    调用 [创建歌曲生成任务](/api-reference/endpoint/music/song-create) 提交歌曲生成任务（支持配置风格、人声性别、纯音乐等参数），获取 `task_id`。
  </Step>

  <Step title="轮询并获取结果">
    通过 [查询歌曲生成状态](/api-reference/endpoint/music/song-pending) 轮询任务，获取最终歌曲、封面与歌词。
  </Step>
</Steps>

## 相关资源

<CardGroup cols={2}>
  <Card title="歌词生成 API" icon="pen-line" href="/api-reference/endpoint/music/lyrics-create">
    根据提示词生成结构化歌词内容。
  </Card>

  <Card title="歌曲生成 API" icon="music" href="/api-reference/endpoint/music/song-create">
    基于歌词或提示词创建完整歌曲任务。
  </Card>

  <Card title="歌曲状态查询" icon="clock" href="/api-reference/endpoint/music/song-pending">
    根据 `task_id` 轮询歌曲生成结果。
  </Card>

  <Card title="计费规则" icon="credit-card" href="/guides/account/billing">
    查看音乐生成的积分消耗规则。
  </Card>
</CardGroup>