MoonApiX Docs

Appearance

音乐查询和下载 ​

音乐任务提交后会返回任务 ID。使用通用任务查询接口查询单个任务，并在任务成功后播放或下载媒体结果。

查询单个任务 ​

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

下载媒体 ​

任务成功后，响应里通常会包含 media、audio_url、video_url、image_url 或类似字段。使用返回的 URL 播放或下载媒体。

media[].suno_audio_id 是后续音乐编辑和后处理常用的音频 ID。延展音乐、转换 WAV、人声分离和创建 MP4 等请求需要 audioId 时，优先使用成功任务返回的 suno_audio_id。

bash
curl -L "https://example.com/result.mp3" -o song.mp3

常见状态 ​

状态说明
pending / SUBMITTED已提交或准备中。
running / QUEUED / IN_PROGRESS正在处理。
succeeded / SUCCESS已完成。
failed / FAILURE任务失败。
cancelled任务已取消。

查询建议 ​

  • 保存每次提交返回的 task_id。
  • 对需要后续编辑或后处理的音乐任务，同时保存 media[].suno_audio_id。
  • 前端展示时先判断 status，不要只根据 URL 字段判断成功。
  • 只有成功状态才展示或下载媒体。
  • 失败时读取 fail_reason、error.code 和 error.message。
  • 长任务建议使用 Webhook，同时保留主动查询。

相关页面 ​