音乐

MoonApiX 音乐接口用于生成歌曲、歌词、音效和音乐后处理任务。音乐任务统一通过 POST /v1/tasks 提交，再通过 GET /v1/tasks/{task_id} 查询状态和结果。

基本流程

1. 选择音乐模型，例如 suno-music-v5.5 或 suno-lyrics。
2. 调用 POST /v1/tasks 提交任务。
3. 保存响应中的 task_id。
4. 调用 GET /v1/tasks/{task_id} 查询任务。
5. 任务成功后读取音频、封面、歌词或其他媒体结果。
6. 任务失败时读取 fail_reason 或 error.message。

场景页面

页面	适合场景
音乐生成	生成歌曲、纯音乐和音效。
音乐编辑	延展、重新创作、伴奏、人声、Mashup 和替换片段。
音乐后处理	歌词、封面、WAV、MIDI、MP4 和人声分离。
查询和下载	查询任务状态，读取和下载媒体结果。

生成音乐

curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music-v5.5",
    "prompt": "A hopeful pop song about finding light after a long night.",
    "style": "Pop, Warm, Emotional",
    "title": "Morning Light",
    "customMode": true,
    "instrumental": false,
    "callBackUrl": "https://example.com/moonapix/webhook"
  }'

生成歌词

curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-lyrics",
    "prompt": "写一首关于夏夜海边、温柔重逢的中文流行歌词。",
    "callBackUrl": "https://example.com/callback"
  }'

查询任务

curl https://moonapix.com/v1/tasks/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

常用模型

场景	推荐默认模型	可用模型
生成音乐	suno-music-v5.5	suno-music-v4、suno-music-v4.5、suno-music-v4.5-plus、suno-music-v4.5-all、suno-music-v5、suno-music-v5.5
生成音效	suno-sounds-v5	suno-sounds-v5
延展音乐	suno-extend-v5.5	suno-extend-v4、suno-extend-v4.5、suno-extend-v4.5-plus、suno-extend-v4.5-all、suno-extend-v5、suno-extend-v5.5
上传并重新创作	suno-upload-cover-v5.5	suno-upload-cover-v4、suno-upload-cover-v4.5、suno-upload-cover-v4.5-plus、suno-upload-cover-v4.5-all、suno-upload-cover-v5、suno-upload-cover-v5.5
上传并延展	suno-upload-extend-v5.5	suno-upload-extend-v4、suno-upload-extend-v4.5、suno-upload-extend-v4.5-plus、suno-upload-extend-v4.5-all、suno-upload-extend-v5、suno-upload-extend-v5.5
添加伴奏	suno-add-instrumental-v5.5	suno-add-instrumental-v4.5-plus、suno-add-instrumental-v5、suno-add-instrumental-v5.5
添加人声	suno-add-vocals-v5.5	suno-add-vocals-v4.5-plus、suno-add-vocals-v5、suno-add-vocals-v5.5
生成 Mashup	suno-mashup-v5	suno-mashup-v4、suno-mashup-v4.5、suno-mashup-v4.5-plus、suno-mashup-v4.5-all、suno-mashup-v5
生成歌词	suno-lyrics	suno-lyrics
转换 WAV	suno-wav	suno-wav
替换片段	suno-replace-section	suno-replace-section
人声分离	suno-vocal-removal	suno-vocal-removal
生成 MIDI	suno-midi	suno-midi
创建 MP4	suno-mp4	suno-mp4
生成封面	suno-cover	suno-cover

使用建议

• 歌曲生成建议同时提供 prompt、style 和 title，结果更稳定。
• 纯音乐任务把 instrumental 设置为 true。
• 延展、WAV、人声分离和 MP4 等跟进任务需要成功任务返回的 media[].suno_audio_id 作为 audioId。
• 耗时任务建议同时配置回调并保留主动查询逻辑。
• 下载结果前先检查任务状态是否为成功状态。

更多参数和响应结构见 API Reference。