众扬汇 AI 开放平台 API 文档

RIFF.9 音乐风格替换模式

OpenAPI Specification

接口:POST /riffusion/generate(完整地址 https://api.allyang.cn/riffusion/generate);该路径与 RIFF.1 共用,只是参数要求不同。

鉴权:Bearer 令牌写入请求头 Authorization,形如 Authorization: Bearer {{YOUR_API_KEY}}。

请求体参数(application/json)

本模式沿用 RIFF.1 的参数集合,区别是把 morph 列为必填,并须把其中的变形方式固定为 swap_sound;下列各项的名称、类型与必填性均按原文契约列出。

  • model:必填,string,所选模型名称,取值参照 RIFF.1 的模型枚举。
  • lyrics:必填,string,歌词正文内容。
  • tag:必填,string,音乐风格标签。
  • title:必填,string,歌曲标题。
  • morph:必填,object,变形设置对象;其下子项一概不可省略。
    • riff_id:string,已完成创作歌曲的编号。
    • transform:string,变形方式,本模式固定填 swap_sound。
    • normalized_lyrics_strength:number,歌词强度系数。
    • normalized_sound_prompt_strength:number,音色提示强度系数。
    • normalized_weirdness:number,奇特度系数。
    • normalized_cover_strength:integer,翻唱强度系数。
    • normalized_variation_strength:null,变异强度系数。
    • duration:integer,作品时长,单位为秒。

响应

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

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