众扬汇 AI 开放平台 API 文档

生成歌曲(歌手风格)

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: "本页接口说明详见下方接口定义;参数取值与返回以本平台实测为准。"
  version: 1.0.0
paths:
  /suno/submit/music:
    post:
      summary: '生成歌曲(歌手风格) '
      deprecated: false
      description: "接入步骤:A. 生成音乐:通过生成歌曲接口生成后,取其中一首歌的 clip_id;B. 新建 Persona:clip_id 需为系统内已存在的歌曲(不能是 uploader),不可跨账号,账号下线后不可用;C. 使用 persona_id 创作:mv 取 chirp-v3-5-tau 或 chirp-v4-tau,task 取 artist_consistency,persona_id 为上一步返回,artist_clip_id 为 A 步骤的 clip_id,可跨账号。"
      tags:
        - 音频接口/Suno文生歌
      parameters:
        - name: accept
          in: header
          description: "该字段的取值与含义以本平台实际返回为准。"
          required: false
          example: '*/*'
          schema:
            type: string
        - name: content-type
          in: header
          description: "该字段的取值与含义以本平台实际返回为准。"
          required: true
          example: application/json
          schema:
            type: string
        - name: Authorization
          in: header
          description: "该字段的取值与含义以本平台实际返回为准。"
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
            default: Bearer {{YOUR_API_KEY}}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                generation_type:
                  type: string
                tags:
                  type: string
                negative_tags:
                  type: string
                mv:
                  type: string
                title:
                  type: string
                task:
                  type: string
                persona_id:
                  type: string
                artist_clip_id:
                  type: string
              required:
                - prompt
                - generation_type
                - tags
                - negative_tags
                - mv
                - title
                - task
                - persona_id
                - artist_clip_id
            example:
              prompt: |-
                [Verse]
                你从清晨到黄昏
                一直在我身边温暖
                风吹雨打也不怕
                紧握手永不分开

                [Verse 2]
                有你在我不孤单
                就像繁星在夜晚
                路再长也不觉得远
                因为你是我的光

                [Chorus]
                老公老公我爱你
                你是世界的唯一
                无论在天涯海角
                心如影随形不离

                [Verse 3]
                你是我的避风港
                每天夜里梦都是你
                即使前路多辛苦
                有你一切多美丽

                [Chorus]
                老公老公我爱你
                你是世界的唯一
                无论在天涯海角
                心如影随形不离

                [Bridge]
                生命中的每一刻
                有你陪伴去体会
                所有明天都更好
                因为有你我无敌
              generation_type: TEXT
              tags: electronic, pop
              negative_tags: ''
              mv: chirp-v4-tau
              title: 老公
              task: artist_consistency
              persona_id: 9c1e0a2b-7d44-4f10-9a53-2b1c8e6d0f11
              artist_clip_id: 9c1e0a2b-7d44-4f10-9a53-2b1c8e6d0f11
      responses:
        '200':
          description: "该字段的取值与含义以本平台实际返回为准。"
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

使用提示:本页接口的 Base URL 为 https://api.allyang.cn,请求头需携带 Authorization: Bearer <令牌>(令牌在控制台「令牌管理」中创建)。示例中的任务 ID、时间戳与文件地址均为示意值,实际以平台返回为准。

模型名请在「模型广场」复制后填入,不要手输;计费、限流与在售清单以平台实测为准(部分数值待补)。