API reference
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. Suno(音乐)
API reference
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  • 系统内部接口
    • 用户查询账号信息
  • OpenAI
    • 聊天
      • 文本聊天
      • 识图
    • Responses
      • 创建模型响应
    • OpenAI-Realtime
      • Realtime
    • Completions
      • Instruct
    • 音频接口(Audio)
      • 音频转文本
      • 创建翻译
      • 文本转音频
    • 图像
      • 创建图像
      • 创建图像编辑
      • 创建图像变化
    • 嵌入
      • 创建嵌入
    • 审核
      • 创建审核
    • 模型
      • 获取模型列表
    • 帮助中心
      • 常见问题及解决办法
  • Anthropic
    • Anthropic Claude
  • Suno(音乐)
    • 场景一:续写音乐并获取完整音乐
    • 场景二:Cover 音乐:音乐翻版\修改风格
    • 场景三:Replace Section:替换片段
    • 场景四:Persona:歌手风格
    • 场景五:stems:声曲分离(仅限chirp_auk)
    • 场景六:Timing:歌词、音频时间线(仅限chirp_auk)
    • 场景七:wav:获取 wav 格式文件
    • 场景八:mp4:生成 mp4 mv 视频(仅限chirp_auk)
    • 生成音乐
      POST
    • 上传音乐
      POST
    • 歌曲拼接
      POST
    • 新建 Persona
      POST
    • 声曲分离
      GET
    • Timing:歌词、音频时间线
      GET
    • 获取 wav 格式文件
      GET
    • 生成 mp4 mv 视频
      GET
    • 生成歌词
      POST
    • 查询单个任务
      GET
    • 批量查询任务
      POST
    • 批量查询歌曲
      GET
  • Udio(音乐)
    • 官方格式
      • 生成音乐
      • 查询单个任务
  • Midjourney API文档(生图)
    • 快速教学-完整流程一遍过
    • 怎么切换不同的速度
    • 任务提交
      • 提交Imagine任务
      • 提交Action任务
      • 提交Blend任务
      • 提交Describe任务
      • 提交Modal
      • 提交Shorten任务
      • 提交swap_face任务
      • 上传文件到discord
    • 任务查询
      • 指定ID获取任务
      • 根据ID列表查询任务
      • 根据ID列表查询任务-字段displays
      • 获取任务图片的seed
      • 查询所有任务
      • 分页查询任务
      • 查询任务队列
      • 取消任务
  • Flux(生图)
    • 官方格式
      • 生成图片
      • 微调
      • 查询任务
    • OpenAI Dalle3格式
  • Recraft(生图)
    • 官方格式
      • 附录
      • Generate Image(生成图片)
      • Vectorize Image(矢量化图片)
      • Remove Background(删除背景)
      • Clarity Upscale(清晰度提升)
      • Generative Upscale(生成高清)
      • Create style(创建样式)
    • OpenAI Dalle3格式-生成图片
  • Ideogram(生图)
    • 官方文档(实时更新)
    • Generate with Ideogram 3.0
    • Edit with Ideogram 3.0
    • Remix with Ideogram 3.0
    • Reframe with Ideogram 3.0
    • Replace Background with Ideogram 3.0
    • Upscale
    • Describe
    • Generate(legacy)
    • Edit(legacy)
    • Remix(legacy)
  • Luma(视频)
    • 官方API格式接口
      • 生成视频
      • 单个查询任务
    • RixAPI格式接口
      • 任务提交
        • 文生视频
        • 图生视频
        • 扩展视频
        • 视频生成音频
        • 获取视频无水印链接
      • 任务查询
        • 单个查询任务
        • 批量查询任务
  • Runway(视频)
    • 官方API接口格式
      • 从图像生成视频
      • 获取任务详细信息
    • 逆向格式
      • generate(文本)
      • generate(参考图片)
      • video2video 视频转视频 风格重绘
      • Act-one 表情迁移
      • feed-获取任务
  • PIKA(视频)
    • generate(文本)
    • generate(参考图片)
    • generate(参考视频/扩展视频)
    • feed
  • 可灵API(官方接口)
    • 建议直接看官方文档
    • Callback协议
    • 生成图像
    • 文生视频
    • 图生视频
    • 多图参考生视频
    • 视频特效
    • 视频延长
    • 对口型
    • 虚拟试穿
    • 查询任务(单个)
  • Replicate 通用接口
    • 创建任务
    • 查询任务
  • MiniMax海螺
    • 官方文档
    • 图片生成
    • 视频生成
    • 查询任务
    • 文件下载
  • 火山方舟
    • 创建视频
    • 查询视频状态
  1. Suno(音乐)

新建 Persona

POST
/suno/persona/create
最后修改时间:2025-05-06 09:01:08
clip_id 需要系统内存在的,非 uploader
不能跨账号 所以可能账号下线用不了

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
Authorization
string 
可选
默认值:
{{YOUR_API_KEY}}
Body 参数application/json
object {0}
示例
{
  "root_clip_id": "2dd391cd-996b-4843-9738-1aed26f170e4",
  "name": "Persona 标题",
  "description": "Persona 描述",
  "clips": ["2dd391cd-996b-4843-9738-1aed26f170e4"],
  "is_public": true
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/suno/persona/create' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "root_clip_id": "2dd391cd-996b-4843-9738-1aed26f170e4",
  "name": "Persona 标题",
  "description": "Persona 描述",
  "clips": ["2dd391cd-996b-4843-9738-1aed26f170e4"],
  "is_public": true
}'

返回响应

🟢200成功
application/json
Body
id
string 
必需
name
string 
必需
description
string 
必需
image_s3_id
string 
必需
root_clip_id
string 
必需
clip
object 
必需
id
string 
必需
entity_type
string 
必需
video_url
string 
必需
audio_url
string 
必需
image_url
string 
必需
image_large_url
string 
必需
major_model_version
string 
必需
model_name
string 
必需
metadata
object 
必需
is_liked
boolean 
必需
user_id
string 
必需
display_name
string 
必需
handle
string 
必需
is_handle_updated
boolean 
必需
avatar_image_url
string 
必需
is_trashed
boolean 
必需
flag_count
integer 
必需
display_tags
string 
必需
created_at
string 
必需
status
string 
必需
title
string 
必需
play_count
integer 
必需
upvote_count
integer 
必需
is_public
boolean 
必需
allow_comments
boolean 
必需
user_display_name
string 
必需
user_handle
string 
必需
user_image_url
string 
必需
persona_clips
array [object {2}] 
必需
clip
object 
可选
id
integer 
可选
is_suno_persona
boolean 
必需
is_trashed
boolean 
必需
is_owned
boolean 
必需
is_public
boolean 
必需
is_public_approved
boolean 
必需
is_loved
boolean 
必需
upvote_count
integer 
必需
clip_count
integer 
必需
示例
{
    "id": "string",
    "name": "string",
    "description": "string",
    "image_s3_id": "string",
    "root_clip_id": "string",
    "clip": {
        "id": "string",
        "entity_type": "string",
        "video_url": "string",
        "audio_url": "string",
        "image_url": "string",
        "image_large_url": "string",
        "major_model_version": "string",
        "model_name": "string",
        "metadata": {
            "tags": "string",
            "prompt": "string",
            "type": "string",
            "duration": 0,
            "refund_credits": true,
            "stream": true,
            "can_remix": true,
            "is_remix": true,
            "priority": 0
        },
        "is_liked": true,
        "user_id": "string",
        "display_name": "string",
        "handle": "string",
        "is_handle_updated": true,
        "avatar_image_url": "string",
        "is_trashed": true,
        "flag_count": 0,
        "display_tags": "string",
        "created_at": "string",
        "status": "string",
        "title": "string",
        "play_count": 0,
        "upvote_count": 0,
        "is_public": true,
        "allow_comments": true
    },
    "user_display_name": "string",
    "user_handle": "string",
    "user_image_url": "string",
    "persona_clips": [
        {
            "clip": {
                "id": "string",
                "entity_type": "string",
                "video_url": "string",
                "audio_url": "string",
                "image_url": "string",
                "image_large_url": "string",
                "major_model_version": "string",
                "model_name": "string",
                "metadata": {
                    "tags": "string",
                    "prompt": "string",
                    "type": "string",
                    "duration": 0,
                    "refund_credits": true,
                    "stream": true,
                    "can_remix": true,
                    "is_remix": true,
                    "priority": 0
                },
                "is_liked": true,
                "user_id": "string",
                "display_name": "string",
                "handle": "string",
                "is_handle_updated": true,
                "avatar_image_url": "string",
                "is_trashed": true,
                "flag_count": 0,
                "display_tags": "string",
                "created_at": "string",
                "status": "string",
                "title": "string",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": true,
                "allow_comments": true
            },
            "id": 0
        }
    ],
    "is_suno_persona": true,
    "is_trashed": true,
    "is_owned": true,
    "is_public": true,
    "is_public_approved": true,
    "is_loved": true,
    "upvote_count": 0,
    "clip_count": 0
}
上一页
歌曲拼接
下一页
声曲分离
Built with