MoonApiX Docs

Appearance

音乐后处理 ​

音乐后处理用于生成歌词、封面、WAV、MIDI、MP4，以及做人声分离。这些能力统一通过 POST /v1/tasks 提交，并通过 GET /v1/tasks/{task_id} 查询。

路由清单 ​

方法路径用途
POST/v1/tasks创建歌词、封面、格式转换或人声分离任务。
GET/v1/tasks/{task_id}查询任务状态、失败原因和结果。

生成歌词 ​

歌词提示词建议控制在 200 个字符以内，明确写出主题、情绪、语言和大致结构。避免粘贴受版权保护的完整歌词或过长文本；如果任务返回失败，请先缩短并改写 prompt 后重试。

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 \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-cover",
    "taskId": "task_xxx",
    "callBackUrl": "https://example.com/callback"
  }'

转换 WAV ​

bash
curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-wav",
    "taskId": "task_xxx",
    "audioId": "807233aa-438a-4b5c-a203-9b64299ed238",
    "callBackUrl": "https://example.com/callback"
  }'

人声分离 ​

bash
curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-vocal-removal",
    "taskId": "task_xxx",
    "audioId": "807233aa-438a-4b5c-a203-9b64299ed238",
    "type": "split_stem",
    "callBackUrl": "https://example.com/callback"
  }'

生成 MIDI ​

bash
curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-midi",
    "taskId": "task_xxx",
    "callBackUrl": "https://example.com/callback"
  }'

创建 MP4 ​

bash
curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-mp4",
    "taskId": "task_xxx",
    "audioId": "807233aa-438a-4b5c-a203-9b64299ed238",
    "callBackUrl": "https://example.com/callback"
  }'

模型选择 ​

场景推荐默认模型
生成歌词suno-lyrics
生成封面suno-cover
转换 WAVsuno-wav
生成 MIDIsuno-midi
创建 MP4suno-mp4
人声分离suno-vocal-removal

必填字段 ​

模型必填字段
suno-lyricsprompt、callBackUrl
suno-covertaskId、callBackUrl
suno-wavtaskId、audioId、callBackUrl
suno-vocal-removaltaskId、audioId、callBackUrl
suno-miditaskId、callBackUrl
suno-mp4taskId、audioId、callBackUrl

查询结果 ​

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

先检查 status。成功后读取响应中的结果字段；失败时展示 fail_reason 或 error.message。

相关页面 ​