众扬汇 AI 开放平台 API 文档

RIFF.8 人声替换模式

OpenAPI Specification

接口:POST /riffusion/generate(完整地址 https://api.allyang.cn/riffusion/generate)

鉴权:请求头 Authorization: Bearer {{YOUR_API_KEY}}(原文标注为可选)。

请求体参数(application/json)

  • model:必填,string,模型标识。
  • lyrics:必填,string,歌词。
  • tag:必填,string,风格标签。
  • title:必填,string,标题。
  • morph:必填,object,形态参数容器,其下子项如下:
    • riff_id:必填,string,作品 ID。
    • transform:必填,string,变换方式,本模式固定取 swap_vocals。
    • normalized_lyrics_strength:必填,number,歌词强度。
    • normalized_sound_prompt_strength:必填,number,声音提示强度。
    • normalized_weirdness:必填,number,怪异度。
    • normalized_cover_strength:必填,integer,翻唱强度。
    • normalized_variation_strength:必填,类型 null,变化强度。
    • duration:必填,integer,时长。

响应

  • 200:成功;响应体字段结构原文未给出,待补。

请求示例

@json { "model": "FUZZ-1.1", "lyrics": "……", "tag": "民谣", "title": "示例作品", "morph": { "riff_id": "已完成歌曲编号", "transform": "swap_vocals", "normalized_lyrics_strength": 0.5, "normalized_sound_prompt_strength": 0.5, "normalized_weirdness": 0.3, "normalized_cover_strength": 0.5, "normalized_variation_strength": 1, "duration": 60 } } @

人声替换用于换掉成品里的人声表现,权重含义与专业模式一致。

使用提示:本平台 Base URL 为 https://api.allyang.cn,OpenAI 兼容接口路径以 /v1 开头;示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。

本模式的请求体必须携带 morph 对象,其中 transform 固定取 swap_vocals;其余参数与音乐生成接口一致。

状态提示:原文将该接口归入「废弃、未开放」分组,并标注为开发中,接入前请先确认是否已开放。