跳到主要内容

生成音乐

POST 
/api/v1/generate

使用AI模型生成带或不带歌词的音乐。

使用指南​

  • 此接口根据您的文本提示创建音乐
  • 每个请求会生成多个变体
  • 您可以通过自定义模式和纯音乐设置来控制细节级别

参数详情​

  • 自定义模式下（customMode: true）:

    • 如果 instrumental: true：需提供 style 和 title
    • 如果 instrumental: false：需提供 style、prompt 和 title
    • prompt 长度限制：3000字符
    • style 长度限制：200字符
    • title 长度限制：80字符

  • 非自定义模式下（customMode: false）:

    • 无论 instrumental 设置如何，仅需提供 prompt
    • prompt 长度限制：400字符
    • 其他参数应留空

开发者注意事项​

  • 新用户建议：以 customMode: false 开始使用，更简单
  • 生成的文件将保留14天
  • 回调过程分三个阶段：text（文本生成）、first（第一首完成）、complete（全部完成）

Request​

Responses​

请求成功

Callbacks​

POST 
{request.body#/callBackUrl}

当音频生成完成时，系统会调用此回调通知结果。

回调示例​

{
  "code": 200,
  "msg": "All generated successfully.",
  "data": {
    "callbackType": "complete",
    "task_id": "2fac****9f72",
    "data": [
      {
        "id": "8551****662c",
        "audio_url": "https://example.cn/****.mp3",
        "stream_audio_url": "https://example.cn/****",
        "image_url": "https://example.cn/****.jpeg",
        "prompt": "[Verse] 夜晚城市 灯火辉煌",
        "model_name": "chirp-v3-5",
        "title": "钢铁侠",
        "tags": "electrifying, rock",
        "createTime": "2025-01-01 00:00:00",
        "duration": 198.44
      },
      {
        "id": "bd15****1873",
        "audio_url": "https://example.cn/****.mp3",
        "stream_audio_url": "https://example.cn/****",
        "image_url": "https://example.cn/****.jpeg",
        "prompt": "[Verse] 夜晚城市 灯火辉煌",
        "model_name": "chirp-v3-5",
        "title": "钢铁侠",
        "tags": "electrifying, rock",
        "createTime": "2025-01-01 00:00:00",
        "duration": 228.28
      }
    ]
  }
}

Callbacks Responses​

回调接收成功