> ## 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.

# 歌曲生成 V1

> 使用 Music 1.0 的历史参数创建异步歌曲任务

## 说明

使用 Music 1.0 的历史参数创建异步歌曲任务。该接口用于保持已有 V1 调用不受 V2 上线影响。

<Info>
  历史行为保持不变：`custom_mode=true` 时 `lyrics` 作为自定义歌词；`custom_mode=false` 时 `lyrics` 作为自然语言提示词。
</Info>

<Warning>
  该路径仅接受 Music 1.0 模型。Music 2.0 请使用 [歌曲生成 V2](/api-reference/endpoint/music/song-create-v2)。
</Warning>

## 歌曲格式

当参数 `custom_mode` 为 `false` 时，歌词需要按照指定格式输入。歌词由多个歌曲段组成，每个段以结构标签开头。模型通过这些标签引导歌曲结构和歌词发展。

| 标签              | 段落类型      | 是否需要歌词 | 时长参考      | 说明             |
| :-------------- | :-------- | :----- | :-------- | :------------- |
| \[intro-short]  | 前奏 Intro  | ❌ 无歌词  | \~0–10 秒  | 短前奏，纯伴奏引入      |
| \[intro-medium] | 前奏 Intro  | ❌ 无歌词  | \~10–20 秒 | 中长前奏版本         |
| \[inst-short]   | 纯伴奏段      | ❌ 无歌词  | \~0–10 秒  | 中间的器乐演奏段       |
| \[inst-medium]  | 纯伴奏段      | ❌ 无歌词  | \~10–20 秒 | 较长的器乐段         |
| \[outro-short]  | 尾奏 Outro  | ❌ 无歌词  | \~0–10 秒  | 短尾部收束          |
| \[outro-medium] | 尾奏 Outro  | ❌ 无歌词  | \~10–20 秒 | 中长尾部收束         |
| \[verse]        | 主歌 Verse  | ✅ 需要歌词 | 无固定时长     | 承担叙事内容，应有完整句子  |
| \[chorus]       | 副歌 Chorus | ✅ 需要歌词 | 无固定时长     | 歌曲主题部分，应朗朗上口   |
| \[bridge]       | 过渡 Bridge | ✅ 需要歌词 | 无固定时长     | 连接主歌与副歌，增强情绪转换 |


## OpenAPI

````yaml api-reference/endpoint/music/music.openapi.json POST /v1/music/song/create
openapi: 3.1.0
info:
  title: SenseAudio - Music
  version: 1.0.0
servers:
  - url: https://api.senseaudio.cn
    description: 生产环境
security:
  - bearerAuth: []
paths:
  /v1/music/song/create:
    post:
      summary: 歌曲生成 V1
      description: 使用 Music 1.0 的历史参数创建异步歌曲任务。该接口用于保持已有 V1 调用不受 V2 上线影响。
      operationId: musicCreateMusicSong
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
              properties:
                model:
                  type: string
                  description: 已启用的 Music 1.0 模型 label。
                  enum:
                    - senseaudio-music-1.0-260319
                lyrics:
                  type: string
                  description: 自定义歌词或自然语言提示词，具体语义由 custom_mode 决定。
                custom_mode:
                  type: boolean
                  description: 是否使用自定义歌词模式。true 表示歌词，false 表示提示词。
                instrumental:
                  type: boolean
                  description: 是否生成纯音乐。
                style:
                  type: string
                  description: 目标音乐风格。
                title:
                  type: string
                  description: 歌曲标题。
                style_weight:
                  type: number
                  description: 风格权重。
                  minimum: 0
                  maximum: 1
                weirdness_constraint:
                  type: number
                  description: 随机性与怪异度约束。
                  minimum: 0
                  maximum: 1
            example:
              model: senseaudio-music-1.0-260319
              custom_mode: true
              instrumental: false
              lyrics: '[verse]\n海风把旧照片吹到手边...\n[chorus]\n潮汐还记得我们告别那天'
              style: 温暖的中文流行乐，原声吉他
              title: 潮汐记得
              style_weight: 0.7
              weirdness_constraint: 0.2
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  task_id:
                    description: 异步歌曲生成任务 ID，用于查询任务状态。
                    type: string
              example:
                task_id: music-task-01JZ8Y6Z5P1KJ8Q7M5W4A3B2C1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API_KEY
      description: 格式：`Bearer <API_KEY>`

````