众扬汇 AI 开放平台 API 文档

场景十三:高阶参数

本页汇总生成音乐时可用的调节参数。

参数清单

  • 2025 年 6 月新增 3 个:weirdness_constraint、style_weight、audio_weight;
  • 其中 audio_weight 只在 cover(翻版)场景出现;
  • 三个参数取值范围均为 0–1;
  • 2025 年 9 月新增 vocal_gender:女声 f、男声 m。

常规生成示例

text
{
  "prompt": "[Verse]\n<歌词内容,按行分段>\n[Chorus]\n<副歌内容>",
  "generation_type": "TEXT",
  "tags": "house, tight drums",
  "negative_tags": "现代",
  "mv": "chirp-auk",
  "title": "Savor the Flavor",
  "metadata": {
    "create_mode": "custom",
    "control_sliders": {
      "style_weight": 0.4,
      "weirdness_constraint": 0.7
    },
    "can_control_sliders": ["weirdness_constraint", "style_weight"],
    "vocal_gender": "f"
  }
}

说明:为控制篇幅,示例歌词已用占位说明替代原文;字段名、层级与取值写法与接口保持一致。

cover(翻版)示例

cover 场景额外需要 task 与 cover_clip_id,并可调 audio_weight:

text
{
  "prompt": "[Verse]\n<歌词内容>\n[Chorus]\n<副歌内容>",
  "generation_type": "TEXT",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-auk",
  "title": "新年快乐 (Remix)",
  "task": "cover",
  "cover_clip_id": "f31754fc-2c83-4fc1-8a07-70ae218dd0a6",
  "metadata": {
    "create_mode": "custom",
    "control_sliders": {
      "style_weight": 0.68,
      "audio_weight": 0.48,
      "weirdness_constraint": 0.37
    },
    "can_control_sliders": [
      "weirdness_constraint",
      "style_weight",
      "audio_weight"
    ],
    "is_remix": true
  }
}

调参建议

  • style_weight 越高,风格跟随越强;
  • weirdness_constraint 越高,编曲越偏离常规;
  • audio_weight 越高,cover 越贴近原曲音频特征。

待补:以上参数在 cover 之外场景的可用性,以及各参数在具体 mv 版本下的默认值(发布前以实测补充)。