跳转到主要内容
GET
查询音乐生成详情

使用指南

  • 音乐系列中的所有 POST 提交请求都可以通过此接口查询结果。不同模型返回的响应字段不同。

参数详情

  • task_id(必填):音乐生成提交接口返回的唯一任务标识

开发者说明

  • 轮询此接口以检查任务完成状态
  • 任务完成前 files 数组通常为空。语音任务在运行中可能返回中间状态的 voice_status 或 validate_info。
  • 任务失败时,查看 error_message 字段获取详情
  • 单个任务生成多个变体时,可能返回多个音频文件
  • minimax-music-2.6 的详情响应返回 audio_id、audio_url、title、duration 和 prompt
  • credits_amount 在任务层级返回,与 task_id、status 和 files 并列,不会在 files 的每一项中重复出现。

任务数据响应字段

files 数据响应字段

files 数组的内容取决于创建任务的模型。

Voice Generate 结果示例

Voice Validate 或 Regenerate 结果示例

Voice Check 结果示例

JSON 字段详情

separate-vocals

separate_vocals 字段:
  • vocal_url - 提取出的人声音轨 URL
  • instrumental_url - 伴奏音轨 URL

upload-and-separate-vocals

vocal_removal 字段:
  • bass - 贝斯音轨 URL
  • drums - 鼓音轨 URL
  • piano - 钢琴音轨 URL
  • guitar - 吉他音轨 URL
  • vocals - 人声音轨 URL
  • other - 其他音频元素 URL

stem-split

stem_split 字段:
  • backing_vocals_url - 和声 URL
  • bass_url - 贝斯音轨 URL
  • brass_url - 铜管乐器 URL
  • drums_url - 鼓音轨 URL
  • fx_url - 音效 URL
  • guitar_url - 吉他音轨 URL
  • keyboard_url - 键盘音轨 URL
  • percussion_url - 打击乐音轨 URL
  • strings_url - 弦乐音轨 URL
  • synth_url - 合成器音轨 URL
  • vocal_url - 主唱人声 URL
  • woodwinds_url - 木管乐器音轨 URL
  • piano_url - 钢琴音轨 URL

generate-music-cover

generate_cover 是包含封面图对象的 JSON 数组:
  • file_url - 生成的封面图 URL
  • file_type - 文件类型(例如 image)

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

查询参数

task_id
string
必填

音乐生成提交接口返回的唯一任务标识符。

响应

200 - application/json

任务详情获取成功

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填