> ## 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.
# 歌曲生成 V2
> 使用 Music 2.0 的结构化参数创建异步歌曲任务
## 说明
使用 Music 2.0 的结构化参数创建异步歌曲任务，返回 `task_id` 后通过统一查询接口轮询结果。
该接口为异步接口，创建任务后请使用 [查询歌曲任务](/api-reference/endpoint/music/song-pending) 轮询结果。
V2 不接收 V1 的 `custom_mode`、`instrumental`、`title`、`style_weight` 或 `weirdness_constraint` 字段。
仅顶层 `lyrics` 使用 `cl100k_base` 执行 1600 token 限制；`prebuilt_lyrics`、歌词生成和歌词改写不使用该限制。
`prebuilt_lyrics` 用于精确回灌写词结果，与顶层 `lyrics` 互斥。
`attachments` 仅支持 `audio` 类型，且需提供可公开访问的 URL。
`audio_settings.format` 支持 `mp3`、`wav`、`wav32`。
## OpenAPI
````yaml api-reference/endpoint/music/music.openapi.json POST /v2/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:
/v2/music/song/create:
post:
summary: 创建音乐 V2
description: 使用 Music 2.0 的结构化参数创建异步歌曲任务，返回 task_id 后通过统一查询接口轮询结果。
operationId: musicCreateMusicSongV2
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
properties:
model:
type: string
description: 已启用的 Music 2.0 模型 label。
enum:
- senseaudio-music-2.0-260626
prompt:
type: string
description: 歌曲主题或自然语言描述。
mode:
type: string
description: 生成模式。
default: sing
enum:
- sing
- lyrics_to_instrumental
- instrumental
style:
type: string
description: 目标音乐风格。
lyrics:
type: string
description: 用户自带歌词；与 prebuilt_lyrics 互斥，最多 1600 tokens。
attachments:
type: array
description: 参考音频附件列表。
items:
type: object
properties:
type:
type: string
description: 附件类型，目前仅支持 audio。
default: audio
url:
type: string
description: 可公开访问的音频 URL.
required:
- url
prebuilt_lyrics:
type: object
description: 写词预览结果回灌，用于精确渲染。
properties:
lyrics:
type: string
description: 歌词正文，不执行顶层 lyrics 的 token 限制。
caption:
description: 编曲描述。
type: string
title:
type: string
description: 建议标题。
bpm:
type: integer
description: 速度。
key_scale:
type: string
description: 调式。
time_signature:
type: string
description: 拍号。
duration:
type: number
description: 时长，单位秒。
vocal_language:
type: string
description: 演唱语言。
default: zh
required:
- lyrics
audio_settings:
type: object
properties:
format:
type: string
description: 输出音频格式。
default: mp3
enum:
- mp3
- wav
- wav32
duration:
type: number
description: 目标时长，单位秒。
model_settings:
type: object
properties:
additional_prompt:
type: string
description: 附加模型提示词。
lyrics_settings:
type: object
properties:
rhyme:
type: string
description: 自动写词时使用的韵脚。
enhance_theme:
type: boolean
description: 是否增强主题。
default: true
language:
type: string
description: 歌词语言。
default: zh
expect_duration:
type: number
description: 期望歌词时长，默认跟随音频时长。
minimum: 10
maximum: 600
vocal_settings:
type: object
properties:
gender:
type: string
description: 演唱性别。
default: any
enum:
- male
- female
- any
- duet
music_settings:
type: object
properties:
classes:
type: array
description: 乐器或音轨类别。
items:
type: string
bpm:
type: integer
description: 速度。
key:
type: string
description: 调式。
default: auto
time_signature:
type: string
description: 拍号，例如 4/4、3/4、6/8。
default: auto
cover_settings:
type: object
properties:
generate:
type: boolean
description: 是否生成封面。
default: false
prompt_hint:
type: string
description: 封面生成提示词。
ratio:
type: string
description: 封面比例。
default: '1:1'
enum:
- '1:1'
- '3:4'
- '2:3'
- '9:16'
- '16:9'
- '4:3'
example:
model: senseaudio-music-2.0-260626
prompt: 夏夜海边久别重逢
mode: sing
style: 温暖的中文流行乐，原声吉他
audio_settings:
format: mp3
duration: 180
lyrics_settings:
language: zh
enhance_theme: true
vocal_settings:
gender: female
cover_settings:
generate: false
ratio: '1:1'
responses:
'200':
description: 成功
content:
application/json:
schema:
type: object
properties:
task_id:
type: string
description: 异步歌曲生成任务 ID，用于统一查询接口轮询状态。
example:
task_id: music-task-01JZ8Y6Z5P1KJ8Q7M5W4A3B2C1
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API_KEY
description: 格式：`Bearer `
````