api.tu-zi.com-20250411
  1. 场景 3 生成自定义音乐(纯音乐)
api.tu-zi.com-20250411
  • 文件服务
    • 文件上传(file)
      POST
  • 链接分析(url analysis)
    • 链接总结(summary)
      POST
    • 链接聊天(chat)
      POST
    • 字幕导出(subtitle)
      POST
  • 图片生成
    • flux
      • flux 接口文档
      • 官方格式
        • 生成图像(image)
        • 查询任务(get_result)
        • 提示词生成(chat)
        • 生成图像(chat 格式)
      • OpenAI Image 格式
        • 生成(generations)
      • chat 格式
    • ideogram
      • openai images格式
        • 生成
      • openchat chat格式
        • 生成
    • midjourney
      • 任务查询
        • ListByCondition
        • FetchFromTask
        • ImageSeed
      • 任务提交
        • Blend
        • SwapFace
        • Describe
        • Imagine
        • Shorten
        • Modal
        • Action
        • Change
    • gpt4oimage
      • chat 格式
        • gpt-4o-image-vip
      • image/generations 格式(dalle 格式)
        • 创建图像
        • 创建图片编辑
  • 音乐生成
    • suno
      • suno官网原生格式
        • 官网格式
        • 所有接口
          • 音乐生成(generations)
          • 音乐链接转成suno(upload)
          • 查询任务(feed)
          • 生成歌词
          • 查询歌词
          • 获取完整音乐(concat)
        • 场景1 生成自定义音乐(带歌词)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 2 通过提示词直接生成音乐(带歌词)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 4 通过提示词直接生成音乐(纯音乐)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 3 生成自定义音乐(纯音乐)
          • 音乐生成(generations)
            POST
          • 查询任务(feed)
            GET
        • 场景 5 上传自定义音频并续写
          • 续写自定义音频步骤介绍
          • 音乐链接转成suno(upload)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 6 续写音乐并获取完整音乐
          • 步骤 1 音乐生成
          • 步骤 2 查询任务
          • 步骤 3 扩展音乐
          • 步骤 4 查询拓展的任务
          • 步骤 5 获取完整音乐
          • 步骤 6 查询完整音乐的任务
        • 场景 7 Cover音乐(音乐翻版,修改风格)
          • 步骤 1 音乐生成
          • 步骤 2 查询任务
          • 步骤 3 Cover 音乐
          • 步骤 4 查询拓展的任务
      • 自定义格式(已废弃)
        • 音乐生成(create)
        • 查询任务(feed)
    • udio
      • 官方接口格式
        • 生成音乐
        • 查询任务
        • 生成歌词
      • 兼容 openai chat格式
        • 生成音乐
  • 视频生成
    • vidu(官方格式)
      • 普通
        • vidu(chat格式)
        • 创建视频(tasks)
        • 视频状态(state)
        • 视频查询(tasks-get)
        • 高清视频(tasks)
    • runway
      • 官方格式
        • 生成视频(tasks)
        • 查询任务
      • chat 格式
        • 生成视频
      • vip(更快无水印)
        • 官方格式
          • 生成视频(tasks)
          • 查询任务
        • chat 格式
          • 生成视频
    • luma
      • luma(官方格式)
        • 官方格式lumavip⚡️
          • Chat格式lumavip
          • 视频生成(generations)
          • 查询任务(task)
          • 视频扩展(extend)
        • 官方格式lumapro🚀 (优先保证稳定性)
          • Chat格式lumapro
          • 视频生成(generations)
          • 查询任务(task)
          • 视频扩展(extend)
        • 官方格式luma
          • Chat格式luma
          • 视频生成(generations)
          • 查询任务(task)
          • 视频拓展(extend)
      • luma(goamz格式)
        • goamz 格式luma
          • 视频生成(generations)
          • 查询任务(task)
          • 视频拓展(extend)
        • goamz 格式lumavip
          • 视频生成(generations)
          • 查询任务(task)
          • 视频拓展(extend)
      • luma(chatgpt-next-web格式)
        • 视频生成(generations)
        • 视频扩展(extend)
        • 查询任务(task)
        • Chat格式lumavip
    • 可灵(官方格式)
      • 图像生成(暂不支持)
      • 文生视频
      • 图生视频
      • 查询任务
    • pika
      • pika 接口说明
      • 官方格式
        • 生成视频
        • 查询任务
      • openai chat 兼容格式
        • 生成视频
    • pixverse(变身毒液效果等)
      • pixverse(官方格式)(普通)
        • 创建视频
        • 查询视频
        • 获取特效模版
      • pixverse(官方格式)(VIP)
        • 创建视频
        • 查询视频
        • 获取特效模版
    • sora
      • 官方格式
        • 创建视频
        • 查询视频
      • openai chat 格式
        • 生成视频
  • GPTs 相关
    • GPTs相关接口文档
    • GPTs对话
    • 搜索相关 GPTs(chat格式)
    • 搜索相关 GPTs(官方格式)
    • 查询 GPTs 详情(chat格式)
    • 查询 GPTs 详情(官方格式)
    • 批量查询 GPTs 详情(chat格式)
    • 批量查询 GPTs 详情(官方格式)
  • 数字人
    • 官方 API
      • 查询 默认voice 列表
      • 生成数字人视频
      • 获取任务详情
    • 兼容 openai chat 格式
      • 生成数字人
  • 智谱清言(glm)
    • 智谱清言相关 api 接口文档
    • 视频生成
      • 生成(chat 格式)
      • 生成(generations)
      • 查询(async-result)
  • openai
    • 介绍
    • 项目说明
    • 导言
    • 身份验证
    • 发出请求
    • 参数详情
    • 音频(Audio)
      • 创建语音
      • 创建转录
      • 创建翻译
    • 聊天(Chat)
      • gpts 请求
      • 聊天完成块对象
      • 创建聊天补全
    • 自动补全(Completions)
      • 完成对象
      • 创建完成
    • 嵌入(Embeddings)
      • 嵌入对象
      • 创建嵌入
    • 微调(Fine-tuning)
      • 微调作业对象
      • 微调作业事件对象
      • 创建微调作业
      • 列出微调作业
      • 检索微调作业
      • 取消微调
      • 列出微调事件
    • 图像(Images)
      • README
      • 图像对象
      • 创建图像
      • 创建图片编辑
      • 创建图像变体
    • 模型(Models)
      • 模型对象
      • 列出模型
      • 检索模型
      • 删除微调模型
    • 文件(Files)
      • README
      • 文件对象
      • 上传文件
      • 删除文件
      • 检索文件
      • 检索文件内容
      • 列出文件
    • 审查(Moderations)
      • 调节对象
      • 创建内容审核
    • 助手测试版(AssistantsBeta)
      • 辅助对象
      • 辅助文件对象
      • 创建助手
      • 检索助手
      • 修改助手
      • 删除助手
      • 列出助手
      • 创建辅助文件
      • 检索助手文件
      • 删除辅助文件
      • 列出助手文件
    • 线程数(Threads)
      • 线程对象
      • 创建线程
      • 检索线程
      • 修改线程
      • 删除话题
    • 留言(Messages)
      • 消息对象
      • 消息文件对象
      • 创建消息
      • 检索消息
      • 修改留言
      • 列出消息
      • 检索消息文件
      • 列出消息文件
    • 运行(Runs)
      • 运行对象
      • 运行步骤对象
      • 创建运行
      • 检索运行
      • 修改运行
      • 列表运行
      • 提交工具输出以运行
      • 取消运行
      • 创建线程并运行
      • 检索运行步骤
      • 列出运行步骤
    • 已弃用-音频(Audio)
      • 创建转录
      • 创建翻译
  1. 场景 3 生成自定义音乐(纯音乐)

音乐生成(generations)

POST
/v1/suno/generate
生成音乐接口, 可以直接生成也可续写音乐
如果是续写用户上传的音乐则需要在 mv 字段后面加个-upload 如 chirp-v3-5-upload

请求参数

Body 参数application/json
mv
string 
必需
prompt
string 
必需
tags
string 
必需
title
string 
必需
continue_clip_id
null 
必需
continue_at
null 
必需
infill_start_s
null 
必需
infill_end_s
null 
必需
示例
{
  "prompt": "",
  "tags": "heavy metal",
  "mv": "chirp-v3-5",
  "title": "Starry ",
  "continue_clip_id": null,
  "continue_at": null,
  "infill_start_s": null,
  "infill_end_s": null
}

示例代码

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.tu-zi.com/v1/suno/generate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "",
    "tags": "heavy metal",
    "mv": "chirp-v3-5",
    "title": "Starry ",
    "continue_clip_id": null,
    "continue_at": null,
    "infill_start_s": null,
    "infill_end_s": null
}'

返回响应

🟢200成功
application/json
Body
id
string 
必需
clips
array [object {23}] 
必需
id
string 
必需
video_url
string 
必需
audio_url
string 
必需
image_url
null 
必需
image_large_url
null 
必需
is_video_pending
boolean 
必需
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 
必需
reaction
null 
必需
created_at
string 
必需
status
string 
必需
title
string 
必需
play_count
integer 
必需
upvote_count
integer 
必需
is_public
boolean 
必需
metadata
object 
必需
tags
string 
必需
prompt
string 
必需
gpt_description_prompt
null 
必需
audio_prompt_id
string 
必需
history
array [object {5}] 
必需
concat_history
null 
必需
type
string 
必需
duration
null 
必需
refund_credits
null 
必需
stream
boolean 
必需
infill
boolean 
必需
has_vocal
boolean 
必需
is_audio_upload_tos_accepted
boolean 
必需
error_type
null 
必需
error_message
null 
必需
major_model_version
string 
必需
status
string 
必需
created_at
string 
必需
batch_size
integer 
必需
示例
{
  "id": "3d5f0ee4-1d7b-410a-bafd-60a3978284d1",
  "clips": [
    {
      "id": "7070ec00-462e-42ac-9b9f-1074977f473f",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "heavy metal",
        "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
        "gpt_description_prompt": null,
        "audio_prompt_id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
        "history": [
          {
            "id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
            "continue_at": 48.762,
            "type": "upload",
            "source": "web",
            "infill": false
          }
        ],
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": false,
        "has_vocal": true,
        "is_audio_upload_tos_accepted": true,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "4ed4f182-0b5a-4cde-bffe-44fb5237a3aa",
      "display_name": "AmbientLens971",
      "handle": "ambientlens971",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.jpg",
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-07-22T07:56:36.710Z",
      "status": "submitted",
      "title": "Starry ",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90",
      "video_url": "",
      "audio_url": "",
      "image_url": null,
      "image_large_url": null,
      "is_video_pending": false,
      "major_model_version": "v3",
      "model_name": "chirp-v3",
      "metadata": {
        "tags": "heavy metal",
        "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
        "gpt_description_prompt": null,
        "audio_prompt_id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
        "history": [
          {
            "id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
            "continue_at": 48.762,
            "type": "upload",
            "source": "web",
            "infill": false
          }
        ],
        "concat_history": null,
        "type": "gen",
        "duration": null,
        "refund_credits": null,
        "stream": true,
        "infill": false,
        "has_vocal": true,
        "is_audio_upload_tos_accepted": true,
        "error_type": null,
        "error_message": null
      },
      "is_liked": false,
      "user_id": "4ed4f182-0b5a-4cde-bffe-44fb5237a3aa",
      "display_name": "AmbientLens971",
      "handle": "ambientlens971",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.jpg",
      "is_trashed": false,
      "reaction": null,
      "created_at": "2024-07-22T07:56:36.711Z",
      "status": "submitted",
      "title": "Starry ",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": "heavy metal",
    "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "gpt_description_prompt": null,
    "audio_prompt_id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
    "history": [
      {
        "id": "m_2e584f32-7ae3-4b2d-93f6-391f65a01f15",
        "continue_at": 48.762,
        "type": "upload",
        "source": "web",
        "infill": false
      }
    ],
    "concat_history": null,
    "type": "gen",
    "duration": null,
    "refund_credits": null,
    "stream": true,
    "infill": false,
    "has_vocal": true,
    "is_audio_upload_tos_accepted": true,
    "error_type": null,
    "error_message": null
  },
  "major_model_version": "v3",
  "status": "complete",
  "created_at": "2024-07-22T07:56:36.699Z",
  "batch_size": 1
}
上一页
查询任务(feed)
下一页
查询任务(feed)
Built with