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/fetch
Music

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
action
string 
必需
ids
array[string]
必需
示例
{
  "action": "string",
  "ids": [
    "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/fetch' \
--header 'Content-Type: application/json' \
--data-raw '{
  "action": "string",
  "ids": [
    "string"
  ]
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
string 
必需
data
array [object {9}] 
必需
task_id
string 
必需
action
string 
必需
status
string 
必需
fail_reason
string 
必需
submit_time
integer 
必需
start_time
integer 
必需
finish_time
integer 
必需
progress
string 
必需
data
array [object {21}] 
必需
示例
{
  "code": "success",
  "message": "",
  "data": [
    {
      "task_id": "b85c241a-4d97-4ee4-1111-68c053509b24",
      "action": "LYRICS",
      "status": "SUCCESS",
      "fail_reason": "",
      "submit_time": 1720507944,
      "start_time": 1720507944,
      "finish_time": 1720507944,
      "progress": "100%",
      "data": {
        "id": "b85c241a-4d97-4ee4-1111-68c053509b24",
        "text": "[Verse]\n喵星人 喵喵叫\n追逐影子 跳上床\n\n[Verse 2]\n窗外飞鸟 看得见\n小心爪子 伸得远\n\n[Chorus]\n喵喵喵 一起摇滚\n跳上桌子 猛撒欢\n把忧愁 通通甩掉\n喵喵喵 我们摇滚\n\n[Bridge]\n夜深人静 地板上\n偷偷摸摸 又跳上\n\n[Verse 3]\n阳光晒背 午后暖\n懒洋洋地 打个盹\n\n[Chorus]\n喵喵喵 一起摇滚\n跳上桌子 猛撒欢\n把忧愁 通通甩掉\n喵喵喵 我们摇滚",
        "title": "喵星摇滚",
        "status": "complete"
      }
    },
    {
      "task_id": "bee8f32e1994417ba8d7485d1aaf3b26",
      "action": "MUSIC",
      "status": "SUCCESS",
      "fail_reason": "",
      "submit_time": 1720433188,
      "start_time": 1720433204,
      "finish_time": 1720433313,
      "progress": "100%",
      "data": [
        {
          "id": "86e395cb-b4a8-50a7-a081-6a341a48064f",
          "title": "City Lights",
          "handle": "timelesssubgenre031",
          "status": "complete",
          "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"
        },
        {
          "id": "ba6be886-4fde-4b34-bc32-8ae4ed8354ea",
          "title": "City Lights",
          "handle": "timelesssubgenre031",
          "status": "complete",
          "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": 127.2,
            "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/ba6be886-4fde-4b34-bc32-8ae4ed8354ea.mp3",
          "image_url": "https://cdn1.suno.ai/image_ba6be886-4fde-4b34-bc32-8ae4ed8354ea.png",
          "is_public": false,
          "video_url": "https://cdn1.suno.ai/ba6be886-4fde-4b34-bc32-8ae4ed8354ea.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_ba6be886-4fde-4b34-bc32-8ae4ed8354ea.png",
          "is_video_pending": true,
          "is_handle_updated": false,
          "major_model_version": "v3.5"
        }
      ]
    }
  ]
}
修改于 2025-05-18 07:36:21
上一页
创建歌词
下一页
查询单个任务
Built with