Future API
  1. 音频上传
Future API
  • 管理员接口
    • 查询账户信息
      GET
  • 文件服务
    • 文件上传(file)
      POST
  • 链接分析(url analysis)
    • 链接总结(summary)
      POST
    • 链接聊天(chat)
      POST
    • 字幕导出(subtitle)
      POST
  • 图片生成
    • flux
      • flux 接口文档
      • 官方格式
        • 生成图像(image)
        • 查询任务(get_result)
        • 提示词生成(chat)
        • 生成图像(chat 格式)
      • OpenAI Image 格式
        • 生成(generations)
        • 创建图片编辑 Copy
      • chat 格式
        • 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 格式)
        • 创建图像
        • 创建图片编辑
    • nano-banana
      • chat 格式
        • 带图 chat
        • content text 中带图
        • chat
      • image/generations 格式(dalle 格式)
        • 创建图像
        • 创建图片编辑
    • bytedance
      • seedream-v4
        • chat 格式
          • 带图 chat
          • chat
        • image/generations 格式(dalle 格式)
          • 创建图像
          • 创建图片编辑
  • 音乐生成
    • suno
      • suno官网原生格式(已废弃)
        • 官网格式
        • 所有接口
          • 音乐生成(generations)
          • 音乐链接转成suno(upload)
          • 查询任务(feed)
          • 生成歌词
          • 查询歌词
          • 获取完整音乐(concat)
        • 场景1 生成自定义音乐(带歌词)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 2 通过提示词直接生成音乐(带歌词)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 4 通过提示词直接生成音乐(纯音乐)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 3 生成自定义音乐(纯音乐)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 5 上传自定义音频并续写
          • 续写自定义音频步骤介绍
          • 音乐链接转成suno(upload)
          • 音乐生成(generations)
          • 查询任务(feed)
        • 场景 6 续写音乐并获取完整音乐
          • 步骤 1 音乐生成
          • 步骤 2 查询任务
          • 步骤 3 扩展音乐
          • 步骤 4 查询拓展的任务
          • 步骤 5 获取完整音乐
          • 步骤 6 查询完整音乐的任务
        • 场景 7 Cover音乐(音乐翻版，修改风格)
          • 步骤 1 音乐生成
          • 步骤 2 查询任务
          • 步骤 3 Cover 音乐
          • 步骤 4 查询拓展的任务
      • 自定义格式(已废弃)
        • 音乐生成(create)
        • 查询任务(feed)
      • 支持 newapi,rixapi 接入
        • suno api 说明
        • 场景1-灵感模式
          • 场景1 - 灵感模式生成音乐
        • 场景2-自定义模式
          • 场景2 - 自定义歌词、标题和风格
        • 场景3-纯音乐自定义
          • 场景3 - 生成纯音乐（无人声）
        • 场景4-纯音乐灵感
          • 场景4 - 灵感模式生成纯音乐
        • 场景5-续写音频
          • 场景5 - 续写/扩展已有音频
        • 场景6-混音重制
          • 场景6 - 混音重制（使用参考音频）
        • 场景7-替换片段
          • 场景7 - 替换歌曲指定片段
        • 场景8-全轨分离
          • 场景8 - 全轨声曲分离
        • 场景9-人声分离
          • 场景9 - 人声分离
        • 场景10-改写
          • 场景10 - 改写（重新生成）
        • 场景11-重新填词
          • 场景11 - 重新填词 (Overpainting)
        • 查询结果
          • 查询生成任务的结果
        • 音频上传
          • 上传自定义音频文件
            POST
        • MIDI操作
          • 获取音乐的MIDI数据
        • 辅助工具
          • 扩展Style Tags（风格标签）
    • 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 格式
        • 生成视频
    • veo
      • 视频统一格式
        • 创建视频
        • 查询任务
        • 创建视频，带图片
      • newapi 视频格式
        • 创建视频
        • 查询任务
        • 创建视频，带图片
      • chat 格式
        • 流式请求
        • 非流请求
        • 带图片请求
        • 不同比例的视频(横竖屏)
      • OpenAI官方视频格式(适配 newapi)
        • 创建视频
        • 查询视频详情
        • 下载视频(不推荐该方式，查询视频接口有返回 url的)
        • 编辑视频(remix)(不支持)
    • sora-2
      • 视频统一格式
        • 创建视频 带图片
        • 创建视频 （带 Character）
        • 创建视频
        • 查询任务
      • chat 格式
        • 可以@的人物说明
        • 连续修改生成视频
        • 使用公共人物(例如奥特曼)生成视频
        • 流式请求
        • 非流请求
        • 带图片请求
        • 不同比例的视频(横竖屏)
      • OpenAI官方视频格式(适配 newapi)
        • 创建视频
        • 查询视频详情
        • 下载视频(不推荐该方式，查询视频接口有返回 url的)
        • 编辑视频(remix)
        • 创建视频(带 Character)
      • 创建角色接口
        • 创建角色
  • 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）
      • 创建转录
      • 创建翻译
  • 异步 veo3 、gemini deepsearch 等
    • 转换接口说明
    • 流式转换
      • 流式转换接口
    • 异步 gemini-2.5-pro-deepsearch
      • 获取任务链接
      • 查询任务详情
    • 异步 veo3
      • 获取任务链接
      • 查询任务详情
    • 异步 sora
      • 获取任务链接
      • 查询任务详情
  • gemini
    • generateContent
      • 文本非流
      • 文本流式
      • 图片非流
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
    • veo
      • veo 模型
      • veo status
    • Schemas
      • ChatCompletionRequest
      • Scene1_InspirationRequest
      • Message
      • Scene2_CustomRequest
      • TransformSuccessResponse
      • Scene3_InstrumentalCustomRequest
      • ErrorResponse
      • Scene4_InstrumentalInspirationRequest
      • Scene5A_ContinueUploadedRequest
      • Scene5B_ContinueGeneratedRequest
      • Scene6A_RemixUploadedRequest
      • Scene6B_RemixGeneratedRequest
      • Scene7A_ReplaceUploadedRequest
      • Scene7B_ReplaceGeneratedRequest
      • Scene8_AllStemsRequest
      • Scene9_VocalStemsRequest
      • Scene10_RewriteRequest
      • Scene11_OverpaintingRequest
      • ClipResult
      • MidiProcessing
      • MidiComplete
      • Error
    • sora
      • sora model
      • 时长
    • suno
    • Response
      • GenerateSuccess
      • BadRequest
      • Unauthorized
      • NotFound
  1. 音频上传

上传自定义音频文件

POST
/suno/upload

接口说明#

上传自定义音频文件，用于后续操作

使用方法#

支持的格式: mp3, wav, flac 等
返回 clip_id，可用于后续操作

后续操作#

上传后获得的 clip_id 可用于：
场景5: 续写音频 (continue_clip_id)
场景6: 混音重制 (reference_clip_id)
场景7: 替换片段 (infill_clip_id)

请求参数

Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
Body 参数multipart/form-data必填

请求示例代码

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://future-api.vodeshop.com/suno/upload' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

返回响应

🟢200成功
application/json
上传成功
Body

示例
{
    "clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
    "duration": 180.5
}
🟠400请求有误
🟠401未认证
🟠413请求体过大
修改于 2025-11-17 06:15:27
上一页
查询生成任务的结果
下一页
获取音乐的MIDI数据
Built with