MoonApiX Docs

Appearance

生成音乐和音效 ​

音乐生成任务用于创建歌曲、纯音乐和音效。所有任务都通过 POST /v1/tasks 提交，并通过 GET /v1/tasks/{task_id} 查询。

生成歌曲 ​

http
POST /v1/tasks
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"
  }'

生成纯音乐 ​

json
{
  "model": "suno-music-v5.5",
  "prompt": "Warm cinematic background music for a product launch.",
  "style": "Cinematic, Warm, Corporate",
  "title": "Launch Day",
  "customMode": true,
  "instrumental": true,
  "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-sounds-v5",
    "prompt": "A clean notification sound, short, bright, modern.",
    "callBackUrl": "https://example.com/moonapix/webhook"
  }'

常用字段 ​

字段说明
model音乐或音效模型名。
prompt主题、歌词、音效描述或创作要求。
style风格、乐器、情绪。
title标题。
customMode音乐生成参数模式。true 表示自定义提示词、风格和标题；false 表示使用默认参数。
instrumental是否生成纯音乐。
callBackUrl任务完成后的回调地址。

必填字段速查 ​

模型族必填字段
suno-music-*customMode、instrumental、callBackUrl；当 customMode=true 时还需要 prompt、style、title
suno-sounds-v5prompt；建议同时提供 callBackUrl 便于接收任务完成通知

相关页面 ​