MoonApiX Docs

Appearance

音乐 ​

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 和人声分离。
查询和下载查询任务状态，读取和下载媒体结果。

生成音乐 ​

bash
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"
  }'

生成歌词 ​

bash
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"
  }'

查询任务 ​

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

常用模型 ​

场景推荐默认模型可用模型
生成音乐suno-music-v5.5suno-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-v5suno-sounds-v5
延展音乐suno-extend-v5.5suno-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.5suno-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.5suno-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.5suno-add-instrumental-v4.5-plus、suno-add-instrumental-v5、suno-add-instrumental-v5.5
添加人声suno-add-vocals-v5.5suno-add-vocals-v4.5-plus、suno-add-vocals-v5、suno-add-vocals-v5.5
生成 Mashupsuno-mashup-v5suno-mashup-v4、suno-mashup-v4.5、suno-mashup-v4.5-plus、suno-mashup-v4.5-all、suno-mashup-v5
生成歌词suno-lyricssuno-lyrics
转换 WAVsuno-wavsuno-wav
替换片段suno-replace-sectionsuno-replace-section
人声分离suno-vocal-removalsuno-vocal-removal
生成 MIDIsuno-midisuno-midi
创建 MP4suno-mp4suno-mp4
生成封面suno-coversuno-cover

使用建议 ​

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

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