UniAPI API Doc
  1. Suno
UniAPI API Doc
  • OpenAI
    • Audio
      • 文本生成音频
      • 音频转文本
      • 创建转录
    • Chat
      • 聊天接口
    • Completions
      • 自动补全
    • Embeddings
      • 向量接口
    • Images
      • 图像编辑
      • 图像生成
      • 图像变体
    • Models
      • 获取模型列表
    • Moderations
      • 审核
    • Responses
      • response
  • 平台接口
    • 余额
      GET
  • 音乐模型
    • Suno
      • 创建音乐
        POST
      • 创建歌词
        POST
      • 批量获取任务
        POST
      • 查询单个任务
        GET
    • Udio
      • 创建音乐
      • 查询任务
  • 图像模型
    • MidJourney
      • 提交swap_face任务
      • 绘图变化(UPSCALE; VARIATION; REROLL)
      • 执行动作(所有的关联按钮动作UPSCALE; VARIATION; REROLL; ZOOM等)
      • 绘图变化-simple(UPSCALE; VARIATION; REROLL)
      • 提交Blend任务(图生图)
      • 提交Describe任务(图生文)
      • 提交Imagine任务(文生图、文图生图)
      • 提交Modal(提交局部重绘、ZOOM)
      • 提交Shorten任务(prompt分析)
    • ideogram
      • Generates(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
    • FalAI
      • Openai 格式
      • 提交任务
      • 获取任务状态
      • 获取任务结果
    • 即梦
      • Openai 格式
    • Kling
      • 图像生成(文生图/图生图)
      • 图像生成 获取状态
      • 虚拟试穿
      • 虚拟试穿 获取状态
  • 视频模型
    • Luma
      • 生成视频
      • 扩展视频
      • 获取下载地址
      • 获取任务
    • FalAI
      • 提交任务
      • 获取任务状态
      • 获取任务结果
    • Kling
      • 图像生成(文生图/图生图)
      • 图像生成 获取状态
      • 文生视频
      • 文生视频 获取状态
      • 图生视频
      • 图生视频 获取状态
      • 虚拟试穿
      • 虚拟试穿 获取状态
  1. Suno

创建音乐

POST
/suno/submit/music
Music
分为3种模式
1.
灵感模式:
只需要提交以下参数
gpt_description_prompt
make_instrumental
mv
Suno 会自动生成 歌词、标题、风格标签
2.
自定义模式:
需要提交参数
prompt
title
tags
make_instrumental
mv

请求参数

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 
标题
可选
示例
{
  "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"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
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"
}'

返回响应

🟢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 
必需
示例
{
    "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"
}
修改于 2025-05-18 07:36:21
上一页
余额
下一页
创建歌词
Built with