生成歌曲(歌手风格)
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、时间戳与文件地址均为示意值,实际以平台返回为准。模型名请在「模型广场」复制后填入,不要手输;计费、限流与在售清单以平台实测为准(部分数值待补)。