UniAPI API Doc
首页全部OpenAI平台接口音乐模型图像模型视频模型
首页全部OpenAI平台接口音乐模型图像模型视频模型
  1. Suno
  • Suno
    • 声曲分离
      GET
    • 歌词、音频时间线
      GET
    • 获取 wav 格式文件
      GET
    • 生成 mp4 mv 视频
      GET
    • 创建音乐
      POST
    • 创建歌词
      POST
    • 批量获取任务
      POST
    • 查询单个任务
      GET
  • Udio
    • 创建音乐
      POST
    • 查询任务
      GET
  1. Suno

创建音乐

POST
/suno/submit/music
分为3种模式
1.
灵感模式:
只需要提交以下参数
gpt_description_prompt
make_instrumental
mv
Suno 会自动生成 歌词、标题、风格标签
2.
自定义模式:
需要提交参数
prompt
title
tags
make_instrumental
mv
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.uniapi.io/suno/submit/music' \
--header 'Content-Type: application/json' \
--data-raw '{
  "continue_at": 0,
  "continue_clip_id": "string",
  "gpt_description_prompt": "string",
  "make_instrumental": true,
  "mv": "string",
  "prompt": "string",
  "tags": "string",
  "task_id": "string",
  "title": "string"
}'
响应示例响应示例
{
    "id": "86e395cb-b4a8-50a7-a081-6a341a48064f",
    "title": "City Lights",
    "handle": "timelesssubgenre031",
    "status": "complete",
    "user_id": "1",
    "is_liked": false,
    "metadata": {
        "tags": "emotional punk",
        "type": "gen",
        "prompt": "[Verse]\n猫咪在跳舞 喵喵喵\n摇着尾巴 转圈圈\n灯光闪烁 猫眼闪\n每只猫咪 都是明星\n\n[Verse 2]\n猫抓吉他 声音大\n爪子弹奏 猫咪乐\n嗷嗷叫声 唱不停\n猫咪乐队 要震天\n\n[Chorus]\n喵 喵 喵喵喵\n猫咪歌声 在回荡\n喵 喵 喵喵喵\n喵星狂欢 到天亮\n\n[Verse 3]\n窗边猫咪 打鼓棒\n爪爪敲击 节拍响\n大喵小喵 一起唱\n猫咪乐园 嗨翻天\n\n[Bridge]\n猫咪回忆 小鱼干\n跳舞奔跑 无忧烦\n一起歌唱 欢笑传\n猫咪摇滚 不会散\n\n[Chorus]\n喵 喵 喵喵喵\n猫咪歌声 在回荡\n喵 喵 喵喵喵\n喵星狂欢 到天亮",
        "stream": true,
        "history": null,
        "duration": 125.44,
        "error_type": null,
        "error_message": null,
        "concat_history": null,
        "refund_credits": false,
        "audio_prompt_id": null,
        "gpt_description_prompt": null
    },
    "reaction": null,
    "audio_url": "https://cdn1.suno.ai/86e395cb-b4a8-50a7-a081-6a341a48064f.mp3",
    "image_url": "https://cdn1.suno.ai/image_86e395cb-b4a8-50a7-a081-6a341a48064f.png",
    "is_public": false,
    "video_url": "https://cdn1.suno.ai/86e395cb-b4a8-50a7-a081-6a341a48064f.mp4",
    "created_at": "2024-07-08T10:06:28.420Z",
    "is_trashed": false,
    "model_name": "chirp-v3.5",
    "play_count": 0,
    "display_name": "TimelessSubgenre031",
    "upvote_count": 0,
    "image_large_url": "https://cdn1.suno.ai/image_large_86e395cb-b4a8-50a7-a081-6a341a48064f.png",
    "is_video_pending": true,
    "is_handle_updated": false,
    "major_model_version": "v3.5"
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
continue_at
integer 
续写时间点
可选
continue_clip_id
string 
续写的歌曲ID
可选
gpt_description_prompt
string 
GPT生成歌词说明
可选
make_instrumental
boolean 
是否纯音乐
必需
mv
string 
模型
必需
prompt
string 
歌词prompt
必需
tags
string 
tag
可选
task_id
string 
任务ID
可选
title
string 
标题
可选
generation_type
string 
可选
生成类型 默认为 TEXT
negative_tags
string 
不希望出现的风格
可选
task
string 
可选
续写时 应该为 extend
示例

返回响应

🟢200成功
application/json
Body
id
string 
任务ID
必需
title
string 
标题
必需
handle
string 
必需
status
string 
状态
必需
user_id
string 
用户ID
必需
is_liked
boolean 
必需
metadata
object 
必需
tags
string 
必需
type
string 
类型
必需
prompt
string 
prompt
必需
stream
boolean 
必需
history
null 
必需
duration
number 
必需
error_type
null 
必需
error_message
null 
必需
concat_history
null 
必需
refund_credits
boolean 
必需
audio_prompt_id
null 
必需
gpt_description_prompt
null 
必需
reaction
null 
必需
audio_url
string 
必需
image_url
string 
必需
is_public
boolean 
必需
video_url
string 
必需
created_at
string 
必需
is_trashed
boolean 
必需
model_name
string 
必需
play_count
integer 
必需
display_name
string 
必需
upvote_count
integer 
必需
image_large_url
string 
必需
is_video_pending
boolean 
必需
is_handle_updated
boolean 
必需
major_model_version
string 
必需
修改于 2025-07-02 07:36:47
上一页
生成 mp4 mv 视频
下一页
创建歌词
Built with