跳转至

1. 模型说明

下表为各编码支持的能力（✅ 支持，— 不支持）。文件上传与任务查询在已开通任一生成能力的端点上均可使用

商品编码 歌词成曲 提示词成曲 纯音乐 歌曲延长 说明
MaaS_Mureka_v9.5 ✅ ✅ ✅ — —
MaaS_Mureka_v9 ✅ ✅ ✅ — —
MaaS_Mureka_v8 ✅ ✅ ✅ ✅ 延长需传 extend_type（head/tail）
MaaS_Mureka_v7.6 ✅ ✅ ✅ ✅ 延长仅 tail；extend_at 有效范围 [8000,420000] ms
MaaS_Mureka_o2 ✅ ✅ — — 歌词成曲不支持 vocal_id、melody_id；提示词成曲不支持 vocal_id

2. 计费

2.1 平台的计费项与用量

chargeItemCode 中文名 触发接口
lyrics_to_song 歌词成曲 POST .../song/generate
prompt_to_song 提示词成曲 POST .../song/easy-generate
bgm_generation 纯音乐生成 POST .../instrumental/generate
song_extension 歌曲延长 POST .../song/extend

3. 功能接口详情

歌曲类任务响应参数（data，§3.1 / §3.2 / §3.4 / §3.6 共用）

参数名 字段类型 描述
id string 异步歌曲生成任务的 Task ID
created_at integer 任务创建时间的 Unix 时间戳（秒）
finished_at integer 任务完成时间的 Unix 时间戳（秒）
status string 任务当前状态。枚举：preparing、queued、running、streaming、succeeded、failed、timeouted、cancelled
failed_reason string 失败原因（失败时）
choices array 生成成功的歌曲列表（status 为 succeeded 时）；元素含 url、duration、stream_url 等音频信息

3.1 Lyrics to song

3.1.1 请求 url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/generate

3.1.2 请求 Body 参数

参数名 字段类型 是否必填 默认值 描述
lyrics string 是 - 生成歌曲的歌词，最多 5000 个字符
n integer 否 2 每次请求生成的歌曲数量，默认为 2，最大为 3。将按生成的歌曲数量计费
prompt string 否 - 通过提示词控制音乐生成，最多 1024 个字符。可单独使用，也可与其他选项组合，例如 prompt + vocal_id
gender string 否 - 指定生成歌曲偏好人声性别（枚举：female、male）；若上传音频中已有人声特征，则以上传音频为准
reference_id string 否 - 通过参考音乐控制生成，ID 由 files/upload 接口上传（purpose: reference）得到。可单独使用，也可与 reference_id + vocal_id 等组合
vocal_id string 否 - 使用指定音色，ID 由 song/vocal-clone 接口生成。可单独使用，也可与 reference_id、prompt 等组合
melody_id string 否 - 通过旋律创意控制生成，ID 由 files/upload（purpose: melody）得到。仅可单独使用，不可与其他控制项组合
stream boolean 否 false 为 true 时，任务状态会包含 streaming 阶段，可在此期间获取 stream_url 边生成边播放；部分 legacy 端点不支持流式

3.1.3 响应参数（data）

见上文「歌曲类任务响应参数」。

3.1.4 请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/generate' \
--header 'Authorization: Bearer {YOUR_AK}' \
--header 'Content-Type: application/json' \
--data '{
  "lyrics": "[Verse]\nIn the stormy night, I wander alone",
  "prompt": "r&b, slow, passionate, male vocal",
  "n": 2
}'

3.1.5 响应示例

{
  "code": 0,
  "code_msg": "success",
  "trace_id": "trace-xxx",
  "data": {
    "id": "1436211",
    "created_at": 1677610602,
    "status": "preparing"
  }
}

3.2 Prompt to song

3.2.1 请求 url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/easy-generate

3.2.2 请求 Body 参数

参数名 字段类型 是否必填 默认值 描述
n integer 否 2 每次请求生成的歌曲数量，默认为 2，最大为 3。将按生成的歌曲数量计费
styles array 否 - 通过风格控制生成，可从枚举中选一个或多个：pop、rock、jazz、r\&b、edm、ambient、folk、latin、k-pop、j-pop、house、gospel、lo-fi
prompt string 否 - 通过提示词控制音乐生成，最多 2000 个字符
reference_id string 否 - 通过参考音乐控制生成，ID 由 files/upload（purpose: reference）得到
vocal_id string 否 - 使用指定音色，ID 由 song/vocal-clone 接口生成
stream boolean 否 false 为 true 时，任务状态会包含 streaming 阶段，可获取 stream_url 边生成边播放

3.2.3 响应参数（data）

见「歌曲类任务响应参数」。

3.2.4 请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/easy-generate' \
--header 'Authorization: Bearer {YOUR_AK}' \
--header 'Content-Type: application/json' \
--data '{
  "styles": ["pop", "rock"],
  "prompt": "A bright summer love song with a catchy chorus",
  "n": 2
}'

3.2.5 响应示例

同 §3.1.5。

3.3 Generate instrumental

3.3.1 请求 url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/instrumental/generate

3.3.2 请求 Body 参数

参数名 字段类型 是否必填 默认值 描述
n integer 否 2 每次请求生成的纯音乐数量，默认为 2，最大为 3。将按生成的数量计费
prompt string 否 - 通过提示词控制纯音乐生成，最多 1024 个字符。仅可单独使用，不可与其他控制项组合
instrumental_id string 否 - 通过参考音乐控制生成，ID 由 files/upload（purpose: instrumental）得到。仅可单独使用
stream boolean 否 false 为 true 时，任务状态会包含 streaming 阶段，可获取 stream_url 边生成边播放

3.3.3 响应参数（data）

参数名 字段类型 描述
id string 异步纯音乐生成任务的 Task ID
created_at integer 任务创建时间的 Unix 时间戳（秒）
finished_at integer 任务完成时间的 Unix 时间戳（秒）
status string 任务当前状态（枚举同歌曲类任务）
failed_reason string 失败原因
choices array 生成成功的纯音乐列表（status 为 succeeded 时）

3.3.4 请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/instrumental/generate' \
--header 'Authorization: Bearer {YOUR_AK}' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "r&b, slow, passionate"
}'

3.3.5 响应示例

同 §3.1.5（data.id 为纯音乐任务 id）。

3.4 Extend song

3.4.1 请求 url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/extend

3.4.2 请求 Body 参数

参数名 字段类型 是否必填 默认值 描述
song_id string 否 - 待延长的歌曲 ID，由 song/generate 生成；仅支持近一个月内生成的歌曲。与 upload_audio_id 互斥
upload_audio_id string 否
 - 待延长音频的上传 ID，由 files/upload（purpose: audio）得到。与 song_id 互斥
lyrics string 是 - 用于延长的歌词，最多 3000 个字符
extend_at integer 是 - 延长起始时间（毫秒）。若大于歌曲时长则按歌曲时长处理；部分通路下有效范围为 [8000, 420000]
extend_type string 否 - 延长方向：tail 从歌曲末尾延长，head 从开头延长。是否必填及可用取值取决于当前接入端点对应的上游模型能力

3.4.3 响应参数（data）

见「歌曲类任务响应参数」。

3.4.4 请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/extend' \
--header 'Authorization: Bearer {YOUR_AK}' \
--header 'Content-Type: application/json' \
--data '{
  "upload_audio_id": "43543541",
  "lyrics": "[Verse]\nIn the stormy night",
  "extend_at": 12234
}'

3.4.5 响应示例

同 §3.1.5。

3.5 Upload file

3.5.1 请求 url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/files/upload

Content-Type: multipart/form-data

3.5.2 请求 form 参数

参数名 字段类型 是否必填 默认值 描述
file file 否 - 待上传的文件对象（非文件名），大小上限 10 MB。与 url 参数互斥
url string 否 - 待上传文件的 URL。与 file 参数互斥
purpose string 是 - 上传用途，枚举及格式要求：reference（mp3/m4a，时长 [30,30] 秒，超出会裁剪）；
melody（mp3/m4a/mid，建议 MIDI，人声提取，时长 [5,60] 秒）；
instrumental（mp3/m4a，时长 [30,30] 秒）；
voice（mp3/m4a，时长 [5,15] 秒）；
audio（mp3/m4a，≤10 MB，通用音频，用于延长等）；
remix（mp3/m4a，时长 [10,350] 秒）；
soundtrack（视频或图片，大文件请用 url；视频 mp4/mov/avi/mkv/webm ≤100 MB，图片 jpg/jpeg/png/webp ≤50 MB）；
lyrics-video（jpg/jpeg/png/webp/gif，歌词视频背景图）

3.5.3 响应参数

参数名 字段类型 描述
id string 文件 ID，可在其他接口中引用
bytes integer 文件大小（字节）
created_at integer 创建时间的 Unix 时间戳（秒）
filename string 文件名
purpose string 上传时指定的用途

3.5.4 请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/files/upload' \
--header 'Authorization: Bearer {YOUR_AK}' \
--form 'purpose="reference"' \
--form 'file=@mydata.mp3'

3.5.5 响应示例

{
  "id": "542321",
  "filename": "mydata.mp3",
  "bytes": 120000,
  "created_at": 1677610602,
  "purpose": "reference"
}

3.6 Query song task

3.6.1 请求 url

GET https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/query/{taskId}

3.6.2 路径参数

参数名 字段类型 是否必填 描述
taskId string 是 歌曲生成任务的 task_id

3.6.3 响应参数（data）

见「歌曲类任务响应参数」。

3.6.4 请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/song/query/435134' \
--header 'Authorization: Bearer {YOUR_AK}'

3.7 Query instrumental task

3.7.1 请求 url

GET https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/instrumental/query/{taskId}

3.7.2 路径参数

参数名 字段类型 是否必填 描述
taskId string 是 纯音乐生成任务的 task_id

3.7.3 响应参数（data）

同 §3.3.3。

3.7.4 请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/mureka/instrumental/query/435134' \
--header 'Authorization: Bearer {YOUR_AK}'