FuhuAPI
  1. Suno
FuhuAPI
  • 快速开始
    • 快速开始
    • 入门必看
    • FuhuAPI 公告
  • API 参考
    • 报错状态码说明
    • OpenAI 格式
      • Chat Completions
      • Response
      • gpt-4o-image生图
      • 图像
      • 图像编辑(gpt-image-1)
      • Embeddings
      • 获取模型列表
      • response id获取结果
      • Hunyuan3D
    • Anthropic 格式
      • Anthropic Claude
    • Gemini
      • 调用 gemini-3-pro-image 指南
      • Gemini生图
      • Gemini 文本对话
    • Midjourney 图像生成
      • 快速教学-完整流程一遍过
      • 任务查询
        • 分页查询
        • 指定ID获取任务
      • 提交Imagine任务
      • 提交视频任务
      • 提交编辑任务
      • 提交Action任务
      • 提交Blend任务
      • 提交Describe任务
      • 提交Modal
    • 图像生成
      • Replicate(image)
        • 创建任务-通用
        • 查询任务
        • 创建任务
      • 豆包生图
        • seededit-image-generation
        • seededit-Image Editing
    • 音乐生成
      • Suno
        • 设置 suno 版本
        • Suno API 场景应用指南
        • 生成歌词
          POST
        • 生成音乐
          POST
        • 上传音乐
          POST
        • 歌曲拼接
          POST
        • 全轨声曲分离
          POST
        • 单轨声曲分离
          POST
        • 新建 Persona
          POST
        • 拓展 style tags
          POST
        • 查询单个任务
          GET
        • 生成 mp4 mv 视频
          GET
        • 获取 wav 格式文件
          GET
        • Timing:歌词、音频时间线
          GET
        • 批量查询任务
          POST
        • 获取 midi
          GET
    • 视频生成
      • sora-2
        • 官方格式
          • 创建视频
          • 混编视频
          • 检索视频
          • 删除视频
          • 下载视频
        • 逆向
          • 逆向异步格式
            • sora逆向异步
            • sora逆向查回
          • sora-2视频逆向格式
      • veo3
        • 逆向异步格式
          • veo3逆向异步
          • veo3逆向查回
        • veo3-chat格式
      • kling (video)
        • Callback协议
        • 扩图
        • 生成图像
        • 文生视频
        • 图生视频
        • 视频延长
        • 虚拟试穿
        • 对口型
        • 视频特效
        • 查询任务(单个)
      • runway(video)
        • 官方格式
          • 从图像生成视频
          • 获取任务详细信息
        • 逆向格式
          • generate(文本)
          • generate(参考图片)
          • video2video 视频转视频 风格重绘
          • Act-one 表情迁移
          • feed-获取任务
      • MiniMax 海螺(video)
        • 官方文档
        • 视频生成
        • 查询任务
        • 文件下载
      • luma (video)
        • 官方API格式
          • 生成视频
          • 单个查询任务
    • 音频
      • 文本转音频
      • 音频转文本
      • 创建翻译
  • 代码示例
    • 代码示例
  • 集成指南
    • 最佳实践
      • Gemini CLI 接入说明
      • Claude code 接入说明
      • FuhuAPI 账户余额查询API 使用说明
      • 使用 FuhuAPI 和 OpenAI 官方 API 的重试逻辑说明文档
      • Midjorney调用最佳实践
      • Runway调用最佳实践
    • 应用集成指南
  • 定价计费
    • 关于价格
    • 关于分组
  • 帮助中心
    • 帮助中心
    • 接口稳定性
    • 常见误区
    • 使用困惑
    • 隐私政策
    • 服务条款
  • 数据模型
    • 示例数据模型
    • Sample Schemas
      • Pet
      • Category
      • Tag
    • Schemas
      • 双人特效
      • ChatCompletionRequest
      • 单人特效
      • RequestMessage
      • VideoGenerationRequest
      • ChatCompletionResponse
      • TextGenerateRequest
      • ResponseChoice
      • ImageGenerateRequest
      • ResponseMessage
      • VideoGenerateRequest
      • Usage
      • BaseResponse
      • TextToImageRequest
      • VideoGenerationResponse
      • GenerateResponse
      • EditImageRequest
      • ErrorResponse
      • BlendImagesRequest
      • UpscaleRequest
      • DescribeImageRequest
      • ImageGenerationResponse
      • ImageDescriptionResponse
      • ErrorResponse
  1. Suno

查询单个任务

GET
https://api.fuhuapi.com/suno/fetch/{task_id}

单任务查询#

/suno/fetch/{task_id} 接口允许您检索特定任务的详细状态和结果。这是跟踪进度和获取异步操作结果的主要接口,例如音乐生成、歌词创建、音频上传和拼接任务。
使用此接口监控任务完成情况并检索生成的内容,包括音频 URL、片段 ID、元数据和其他特定于任务的数据。

典型工作流程#

音乐生成:
1.
通过生成音乐片段提交音乐生成请求
2.
在响应中接收 task_id
3.
使用 task_id 轮询此接口,直到状态变为 "SUCCESS"
4.
从 data 字段中提取生成的音乐 URL 和 clip_id
5.
将 clip_id 用于后续操作,如续写、拼接,或获取 MP4 视频和时间轴数据
歌词生成:
1.
通过生成歌词提交歌词生成请求
2.
在响应中接收 task_id
3.
使用 task_id 轮询此接口,直到状态变为 "SUCCESS"
4.
从 data 字段中提取生成的歌词文本
5.
将歌词与生成音乐片段接口一起使用,创建完整的歌曲

请求参数

Path 参数

Header 参数

返回响应

🟢200Successful Response
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.fuhuapi.com/suno/fetch/' \
--header 'Authorization: Bearer {{api-key}}'
响应示例响应示例
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "dcb812bd-40c5-4907-836e-3a7aa9a2e546",
    "action": "MUSIC",
    "status": "NOT_START",
    "fail_reason": "",
    "submit_time": 1747203819,
    "start_time": 1747203819,
    "finish_time": 0,
    "progress": "0%",
    "data": null
  }
}
上一页
拓展 style tags
下一页
生成 mp4 mv 视频
Built with