CURSORAI API接口文档
  1. 文生音乐 Suno
CURSORAI API接口文档
  • CURSORAI
    • 引言
    • 在线调试说明
    • 发出请求
    • 中转站基本介绍
      • API 快速开始指南
      • 联系客服
      • 分组详细表格
      • 分组的特殊性及价格差异
      • 如何新建指定分组的令牌
      • 代理接口调用地址
      • API Key 额度查询服务
      • 免费AI聊天项目导航
    • 聊天(Chat)
      • ChatGpt 接口
        • ChatGPT音频（Audio）
          • GPT-4o-audio
          • 音频转文字 whisper-1
          • 音频转文字 gpt-4o-transcribe
          • 创建语音 gpt-4o-mini-tts
          • 创建翻译 (不支持)
        • ChatGPT聊天（Chat）
          • 聊天完成对象
          • 聊天完成块对象
          • 创建聊天补全 （流式）
          • 创建聊天补全 （非流）
          • 创建聊天识图 （流式）
          • 创建聊天识图 （流式） best64
          • 创建聊天识图 （非流）
          • 创建聊天创作图 （非流）
          • 官方Function calling调用
          • 官方N测试
          • 列出模型
          • 创建聊天函数调用
          • 创建结构化输出
          • 控制推理模型努力程度
          • 创建聊天补全 qwen-mt-turbo
          • 创建聊天补全 deepseek v3.1思考程度 (流式）
        • ChatGPT自动补全（Completions）
          • 完成对象
          • 创建完成
        • ChatGPT嵌入（Embeddings）
          • 嵌入对象
          • 创建嵌入
        • Web 搜索
          • web搜索
      • Anthropic Claude 接口
        • 聊天完成对象
        • 聊天完成块对象
        • 创建聊天补全 （流式） [原生格式]
        • 创建函数调用 （流式） [原生格式]
        • 创建思考聊天 [原生格式]
        • 创建思考聊天
        • 创建聊天补全 （流式）
        • 创建聊天补全 （非流）
        • 创建聊天识图 （流式）
        • 创建聊天识图 （非流）
      • 谷歌Gemini 接口
        • 原生格式
          • 文本生成
          • 文本生成-流
          • 文本生成+思考-流
          • 图片生成
          • 图片生成 gemini-2.5-flash-image
          • 图片生成 gemini-2.5-flash-image 控制宽高比
          • 图片编辑
          • 图片理解
          • 格式化输出
          • 函数调用
          • 文档理解
          • URL context [原生格式]
          • 代码执行
          • google search
          • 视频理解
          • URL context
          • 视频理解-url [原生格式] 开发中
          • Imagen 4 开发中
          • 音频理解
        • chat兼容格式
          • gemini图片创作接口 [chat兼容格式]
          • 聊天接口 [chat兼容格式]
          • 聊天接口-思考1 [chat兼容格式]
          • 聊天接口-思考2 [chat兼容格式]
          • 识图接口 [chat兼容格式]
          • 聊天+读取文件接口 [chat兼容格式]
    • 聊天(Responses)
      • Responses API与Chat API对比
      • 创建模型响应
      • 创建函数调用
      • 创建模型响应(流式返回)
      • 创建模型响应 (控制思考长度)
      • 创建网络搜索
      • 创建模型响应 gpt-5启用思考
      • 创建函数调用 Copy
    • 绘画模型
      • README
      • 图像对象
      • Midjourney
        • 上传图片
        • 提交Imagine任务
        • 根据任务ID 查询任务状态
        • 根据ID列表查询任务
        • 获取任务图片的seed
        • 执行Action动作
        • 提交Blend任务
        • 提交Describe任务
        • 提交Shorten任务
        • 提交Modal
        • 提交swap_face任务
      • Ideogram
        • Generate 3.0（文生图）Generate
        • Generate 3.0（图片编辑）Edit
        • Generate 3.0（图片重制）Remix
        • Generate 3.0（图片重构）Reframe
        • Generate 3.0（替换背景） Replace Background
        • ideogram（文生图）
        • Remix（混合图）
        • Upscale（放大高清）
        • Describe（描述）
      • GPT Image-1
        • 创建 gpt-image-1
        • 编辑 gpt-image-1
        • 蒙版 gpt-image-1
      • DALL·E 3
        • 创建 DALL·E 3
      • FLUX 系列
        • gpt 兼容格式
          • Flux 创建（OpenAI dall-e-3格式）
          • Flux编辑（OpenAI dall-e-3格式）
        • Replicate 官方格式
          • Flux 分辨率
          • 接入教程
          • 创建任务 black-forest-labs/flux-kontext-dev
          • 查询任务
      • 豆包系列
        • doubao-seedream-3-0-t2i-250415
        • doubao-seededit-3-0-i2i-250628
        • doubao-seedream-4-0-250828-文生图
        • doubao-seedream-4-0-250828-图生图
        • doubao-seedream-4-0-250828-多图生图
      • Fal.ai平台
        • 状态码
        • 获取请求结果
        • /fal-ai/nano-banana 文生图
        • /fal-ai/nano-banana/edit 图片编辑
      • 千问 Qwen-Image 系列
        • qwen-image-edit-2509
    • 视频模型
      • veo 视频生成
        • 视频统一格式
          • 状态码
          • 创建视频
          • 创建视频，带图片
          • 查询任务
      • luma 视频生成
        • 官方API格式
          • 状态码
          • 提交生成视频任务
          • 扩展视频
        • 查询任务
          • 查询单个任务
          • 批量获取任务
      • Kling 快手可灵
        • Callback协议
        • 图像生成
        • 文生视频
        • 图生视频
        • 查询任务(免费)
      • Runway 视频生成
        • 状态码
        • 提交视频生成任务
        • 查询视频任务(免费)
      • 即梦 视频生成
        • 状态码
        • 提交视频生成任务
        • 查询视频任务(免费)
      • 海螺 视频生成
        • 状态码
        • 提交视频生成任务
        • 视频任务状态查询
      • 豆包 视频生成
        • 文生视频示例
        • 图生视频-首帧
        • seedance-lite-首尾帧
        • 图生视频-base64编码
        • seedance-lite-参考图
        • 查询单个任务
        • 查询视频生成任务列表-默认
        • 查询视频生成任务列表-搜索多个任务 ID
      • sora 视频生成
        • 异步格式
          • 查询任务
          • 创建视频，带图片 sora-2
          • 创建视频 sora-2
          • 创建视频 sora-2-pro
        • chat格式
          • 创建视频
          • 连续修改生成视频
      • 通义万象
        • 生成视频
        • 视频查询
    • GPTs 相关
      • 简介
      • GPTs对话
    • 系统API
      • 获取令牌列表
      • 新增令牌
      • 获取令牌支持模型
      • 获取账号信息
      • 修改令牌
      • 搜索令牌
      • 删除令牌
    • 文生音乐 Suno
      • 参数
      • 说明
      • 任务提交
        • 生成歌曲(灵感模式)
        • 生成歌曲(自定义模式)
        • 生成歌曲(续写模式)
        • 生成歌曲(歌手风格)
        • 生成歌曲(上传歌曲二次创作)
        • 生成歌曲(拼接歌曲)
        • 生成歌词
        • 歌曲拼接
      • 查询接口
        • 批量获取任务
        • 查询单个任务
        • 获取wav
    • Python配置方式
      • python openai官方库（使用AutoGPT，langchain等）
      • python 连续对话
      • python 使用 语音转文本
      • python 使用文本转语音
      • python 使用Embeddings 向量化
      • python 调用DALL·E
      • python简单调用 openai function-calling demo
      • python 简单langchain 调用openai demo
      • python llama_index 配置
      • Python基础对话
      • Python使用gpt-4o识别图片-本地图片
      • Python使用gpt-4o识别图片
      • Python使用Claude识别图片
      • python 库流式输出
      • gpt realtime模型调用
      • python request 请求 流式输出demo
      • python 使用gpt-image-1 创建编辑图片
    • Rerank 重排序模型
      • 重排序
    • Replicate 聚合平台
      • 接入教程
      • Flux 分辨率
      • 查询任务
      • 创建任务-通过模型version（predictions）
      • 创建任务 stability-ai/stable-diffusion
      • 创建任务 stability-ai/sdxl
      • 创建任务 stability-ai/stable-diffusion-inpainting
      • 创建任务 stability-ai/stable-diffusion-img2img
      • 创建任务 lucataco/flux-schnell-lora
      • 创建任务 lucataco/flux-dev-lora
      • 创建任务 andreasjansson/stable-diffusion-animation
      • 创建任务 sujaykhandekar/object-removal
      • 创建任务 cjwbw/rembg
      • 创建任务 lucataco/animate-diff
      • 创建任务 ideogram-ai/ideogram-v2-turbo
      • 创建任务 black-forest-labs/flux-kontext-dev
      • 创建任务 minimax/video-01-live
      • 创建任务 minimax/video-01
      • 创建任务 recraft-ai/recraft-v3
      • 创建任务 recraft-ai/recraft-v3-svg
      • 创建任务 black-forest-labs/flux-1.1-pro-ultra
      • 创建任务 black-forest-labs/flux-kontext-pro
      • 创建任务 black-forest-labs/flux-kontext-max
      • 创建任务 flux-kontext-apps/multi-image-kontext-max
      • 创建任务 flux-kontext-apps/multi-image-kontext-pro
      • 创建任务 lucataco/remove-bg
      • 创建任务 riffusion/riffusion
      • 创建任务 black-forest-labs/flux-fill-dev
      • 创建任务 black-forest-labs/flux-fill-pro
      • 创建任务 google/imagen-4-fast
      • 创建任务 google/imagen-4-ultra
      • 创建任务 google/imagen-4
      • 创建任务 prunaai/vace-14b
      • /replicate/v1/model/bytedance/seedream-4/predictions
    • Fal-ai 聚合平台
      • 接入教程
      • falai-veo3 视频生成
        • /fal-ai/veo3
        • /fal-ai/veo3/fast/image-to-video
        • /fal-ai/veo3/fast
        • /fal-ai/veo3/requests/{request_id}
        • /fal-ai/veo3/image-to-video
      • 获取请求结果
      • /fal-ai/flux-1/dev
      • /fal-ai/flux-1/dev/image-to-image
      • /fal-ai/flux-1/dev/redux
      • /fal-ai/flux-1/schnell/redux
      • /fal-ai/flux-pro/kontext
      • /fal-ai/flux-pro/kontext/text-to-image
      • /fal-ai/flux-pro/kontext/max
      • /fal-ai/flux-pro/kontext/max/multi
      • /fal-ai/wan/v2.2-a14b/image-to-image
      • /fal-ai/bytedance/seedream/v4/text-to-image
      • /fal-ai/bytedance/seedream/v4/edit
      • /fal-ai/vidu/reference-to-image
      • /fal-ai/imagen4/preview
      • /fal-ai/qwen-image-edit-lora
      • /fal-ai/qwen-image-edit-plus
      • /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
      • /fal-ai/kling-video/v2.5-turbo/pro/image-to-video
      • /fal-ai/flux-lora
      • /fal-ai/flux-lora/image-to-image
      • /fal-ai/flux-lora/inpainting
      • /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
      • /fal-ai/qwen-image-edit-lora
    • php配置方式
      • php使用图片编辑demo
    • nodejs 配置方式
      • nodejs 基础对话
    • 各种插件/软件使用教程
      • Codex 配置教程
      • N8N 工作流使用中转API 教程
      • Gemini CLI 中转站配置使用教程
      • Claude Code 安装使用教程
      • CherryStudio调用cluade MCP
      • Cherry Studio配置教程
      • CherryStudio配置o4推理级别
      • dify添加模型
      • cline 配置教程
      • aider 配置教程
      • Cursor 配置教程
      • lobechat 设置教程
      • ChatBox(推荐使用)
      • 开源gpt_academic
      • nextchat 设置教程
      • zotero gpt 配置方法
      • CLAUDE DEV 配置教程
      • 沉浸式翻译 设置gpt翻译
      • 浏览器插件ChatGPT Sidebar
      • chatgpt-on-wechat 配置教程
      • chatgpt GPT Academic 学术优化配置gpt教程
      • RikkaHub 配置教程
    • 帮助中心
      • AI返回字段: 思考相关
      • HTTP状态码及其含义
      • 自建图床API
      • 上传图片到图床
  1. 文生音乐 Suno

说明

Suno API 接口文档#

基础信息#

API 地址#

默认地址:
https://{BASE_URL}/suno/submit/music
https://{BASE_URL}/suno/fetch

模型支持#

支持模型#

chirp-v3-0 (对应版本 v3.0)
chirp-v3-5 (对应版本 v3.5 )
chirp-v4 (对应版本 v4.0 )
chirp-auk (对应版本 v4.5 )
chirp-v5 (对应版本 v5.0 )

回调通知#

支持 notify_hook 回调地址
要求:
请求方式: POST
接收数据: task数据结构

使用步骤#

1. 创建Suno任务#

2. 查询任务进度#

数据结构#

Task对象#

字段类型示例描述
task_idstringf4a94d75-087b-4bb1-bd45-53ba293faf96任务ID
actionstringMUSIC任务类型: MUSIC(生成歌)、LYRICS(生成歌词)
statusstringSUCCESS任务状态: NOT_START(未启动)、SUBMITTED(已提交处理)、QUEUED(排队)、IN_PROGRESS(执行中)、FAILURE(失败)、SUCCESS(成功)
submitTimenumber1689231405854提交时间
startTimenumber1689231442755开始执行时间
finishTimenumber1689231544312结束时间
failReasonstring[Invalid parameter] Invalid value失败原因(失败时有值)
dataobject-具体数据：音乐(数组)、歌词(单个)

音乐续写#

需要传入 task_id 参数指定任务
修改于 2025-10-15 12:47:42
上一页
参数
下一页
生成歌曲(灵感模式)
Built with