众扬汇 AI 开放平台 API 文档

RIFF.1 音乐生成(专业模式)

OpenAPI Specification

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

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

请求体参数(application/json)

model、lyrics、tag、title 四项不可省略。

  • model:必填,string,所用模型名称,可在 FUZZ-1.0 / FUZZ-1.1 / FUZZ-1.0 Pro / FUZZ-1.1 Pro 中选。
  • lyrics:必填,string,歌词正文。
  • tag:必填,string,风格标签。
  • title:必填,string,作品标题。
  • instrumental:可选,boolean,是否只出伴奏(不含人声),缺省 false。
  • morph:可选,object,变形设置,供翻唱、续写一类玩法使用。
    • riff_id:string,已完成歌曲的编号;与 audio_upload_id 二者填一个。
    • audio_upload_id:string,已上传歌曲的编号;与 riff_id 二者填一个。
    • transform:string,变形方式,可在 cover / extend / inpaint / swap_vocals / swap_sound 中选。
    • normalized_lyrics_strength:number,歌词权重,区间 0 至 1。
    • normalized_sound_prompt_strength:number,音色提示权重,区间 0 至 1。
    • normalized_weirdness:number,奇特度权重,区间 0 至 1。
    • normalized_cover_strength:number,翻唱权重,区间 0 至 1。
    • normalized_variation_strength:number,变化权重,区间 0 至 1,允许为空。
    • crop_end_at:number,续写玩法下续写的起算秒数。
    • replace_start_at:number,替换玩法下的起始秒数。
    • replace_end_at:number,替换玩法下的结束秒数。
    • duration:number,时长(秒),缺省 0。

响应

  • 200:成功;一次返回两个任务编号,供后续查询生成的音乐作品。
  • jobs:array,任务数组,元素含 id(string)。

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