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

# 歌词改写

> 根据修改意见同步改写已有歌词，返回完整的新版本歌词

## 说明

根据修改意见同步改写已有歌词，返回完整的新版本歌词。

<Info>
  该接口为同步接口，请求完成后直接返回改写结果，不需要轮询任务状态。
</Info>

<Warning>
  `lyrics` 应传入完整歌词正文；接口返回完整改写结果，而不是差异片段。
</Warning>

## 接口能力

歌词改写接口适合在保留主题和结构的前提下，对已有歌词进行整体润色、情绪调整、措辞优化或段落重写。

**核心能力：**

* **保留原意**：在不改变主题的基础上改写表达方式
* **按反馈改写**：根据你提供的修改意见调整情绪、措辞或段落
* **返回完整结果**：输出完整的新歌词，而不是局部 diff

## 请求参数

| 参数         | 类型     | 必填 | 说明                                               |
| ---------- | ------ | -- | ------------------------------------------------ |
| `model`    | string | 是  | 已启用的音乐模型 label，当前为 `senseaudio-music-2.0-260626` |
| `lyrics`   | string | 是  | 需要改写的原歌词正文                                       |
| `feedback` | string | 是  | 明确的修改意见，例如情绪、措辞或段落调整                             |

## 请求示例

```bash theme={null}
curl --request POST \
  --url https://nightly.api.senseaudio.cn/v1/music/lyrics/revise \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "senseaudio-music-2.0-260626",
    "lyrics": "[verse]\n海风吹过无人的站台...",
    "feedback": "副歌更有记忆点，减少抽象意象，保留夏夜主题"
  }'
```

## 返回示例

```json theme={null}
{
  "data": [
    {
      "text": "[verse]\n海风吹过熟悉的站台..."
    }
  ]
}
```

## 使用建议

* 保留原歌词的主体结构，再用 `feedback` 说明你要强化的方向
* 如果你希望结果更明确，可以同时指出情绪、画面感、节奏或段落位置
* 需要改写后的歌词直接进入后续歌曲生成流程时，可以继续复用返回的 `data[].text`


## OpenAPI

````yaml api-reference/endpoint/music/music.openapi.json POST /v1/music/lyrics/revise
openapi: 3.1.0
info:
  title: SenseAudio - Music
  version: 1.0.0
servers:
  - url: https://api.senseaudio.cn
    description: 生产环境
security:
  - bearerAuth: []
paths:
  /v1/music/lyrics/revise:
    post:
      summary: 改写歌词
      description: 根据修改意见同步改写已有歌词，返回完整的新版本歌词。
      operationId: musicReviseMusicLyrics
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - lyrics
                - feedback
              properties:
                model:
                  required: true
                  description: 已启用的音乐模型 label。
                  type: string
                  enum:
                    - senseaudio-music-2.0-260626
                lyrics:
                  required: true
                  description: 需要改写的原歌词正文。
                  type: string
                feedback:
                  required: true
                  description: 明确的修改意见，例如情绪、措辞或段落调整。
                  type: string
            example:
              model: senseaudio-music-2.0-260626
              lyrics: |-
                [verse]
                海风吹过无人的站台...
              feedback: 副歌更有记忆点，减少抽象意象，保留夏夜主题
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    description: 改写后的歌词结果列表。
                    type: array
                    items:
                      type: object
                      properties:
                        text:
                          description: 改写后的完整歌词正文。
                          type: string
              example:
                data:
                  - text: |-
                      [verse]
                      海风吹过熟悉的站台...
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API_KEY
      description: 格式：`Bearer <API_KEY>`

````