众扬汇 AI 开放平台 API 文档

RIFF.7 替换模式

OpenAPI Specification

接口:POST /riffusion/generate

状态:原文归入「废弃、未开放/Riffusion」分组,状态为 developing。

说明:本页用于替换已有音乐片段中的局部内容,而不是从零生成。请求参数与 RIFF.1 保持一致,区别只有两点:必须携带 morph 对象,且 morph.transform 固定为 inpaint。

鉴权:请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

  • Authorization:可选,string,默认 Bearer {{YOUR_API_KEY}}。

请求体参数(application/json)

  • model:必填,string,模型标识(原文未给取值与说明,待补)。
  • lyrics:必填,string,歌词内容(原文未给说明,待补)。
  • tag:必填,string,风格标签(原文未给说明,待补)。
  • title:必填,string,标题(原文未给说明,待补)。
  • morph:必填,object,替换控制对象,下列子字段均为必填:
    • riff_id:string,待处理的片段标识(原文未给说明,待补)。
    • transform:string,本模式固定取 inpaint。
    • replace_start_at:number(原文未给说明,待补)。
    • replace_end_at:number(原文未给说明,待补)。
    • normalized_lyrics_strength:number(原文未给说明,待补)。
    • normalized_sound_prompt_strength:number(原文未给说明,待补)。
    • normalized_weirdness:number(原文未给说明,待补)。
    • normalized_variation_strength:integer(原文未给说明,待补)。
    • duration:number(原文未给说明,待补)。

必填字段:model、lyrics、tag、title、morph。

响应

  • 200:成功;返回 JSON 对象,字段结构原文未给出,待补。

请求示例

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

替换适合只改动成品中的一小段,replace_start_at 与 replace_end_at 给出替换区间;其余权重含义与专业模式一致。

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