MoonApiX Docs

Appearance

音乐概览 ​

音乐能力用于生成歌曲、歌词、音效和音乐后处理任务。音乐任务统一通过异步任务接口提交：提交后保存 task_id，再通过通用任务查询接口读取状态、失败原因和媒体结果。

场景入口 ​

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

路由清单 ​

方法路径用途
POST/v1/tasks创建音乐、歌词、音效或音频后处理任务。
GET/v1/tasks/{task_id}查询任务状态、失败原因和结果。
POST/v1/assets/uploads上传或登记可复用的音频素材。
GET/v1/assets/{asset_id}查询素材详情。

标准请求 ​

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/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

先判断 status。只有 status 为 succeeded 或 SUCCESS 时再读取媒体 URL；如果任务失败，响应会包含 fail_reason 或 error 字段用于展示和重试判断。

后续编辑或后处理任务可能需要源任务返回的 media[].suno_audio_id 作为 audioId。例如延展音乐、转换 WAV、人声分离和创建 MP4，都应先等源任务成功后再提交。

相关页面 ​