转换为WAV格式

本页由 ModelFold 文档站根据上游官方 OpenAPI 文档同步生成。接口路径、参数、示例与官方保持一致；品牌与 API 域名已替换为 ModelFold。

接口

POST /jobs/createTask

完整 URL: https://ai.modelfold.online/v1/jobs/createTask

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

文档已更新

若你此前已完成对接，仍可前往旧版文档查看：旧版地址 (https://ai.modelfold.online/docs/)

将现有音乐曲目转换为高质量WAV格式。

使用指南

• 使用此接口从您生成的音乐获取WAV格式文件
• WAV文件提供无压缩音频，适用于专业编辑和处理
• 转换后的文件保持原始音频的完整质量

参数详情

• task_id 标识原始音乐生成任务
• audio_id 在存在多个变体时指定要转换的音频曲目

开发者注意事项

• 生成的WAV文件保留14天
• WAV文件通常比MP3文件大5-10倍
• 处理时间可能因原始音频的长度而异
• 轮询 GET /api/v1/jobs/recordInfo 时，文件地址在 resultJson.resultUrls[0]（回调中为 audio_wav_url / video_url）。

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	模型名称 示例：ai-music-api/convert-to-wav-format。
callBackUrl	string	否	接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 Webhook 校验指南 了解签名验证实现方法 示例：https://api.example.com/callback。
input	object	是	生成任务的输入参数
input.task_id	string	是	音乐生成任务的唯一标识符。应为"生成音乐"或"延长音乐"接口返回的task_id。 示例：5c79****be8e。
input.audio_id	string	是	要转换的特定音频曲目的唯一标识符。此ID在音乐生成完成后的回调数据中返回。 示例：e231****-****-****-****-****8cadc7dc。

请求示例

curl -X POST "https://ai.modelfold.online/v1/jobs/createTask" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ai-music-api/convert-to-wav-format",
  "callBackUrl": "https://api.example.com/callback",
  "input": {
    "task_id": "5c79****be8e",
    "audio_id": "e231****-****-****-****-****8cadc7dc"
  }
}'

{
  "model": "ai-music-api/convert-to-wav-format",
  "callBackUrl": "https://api.example.com/callback",
  "input": {
    "task_id": "5c79****be8e",
    "audio_id": "e231****-****-****-****-****8cadc7dc"
  }
}

响应

200 — 请求成功

参数	类型	必填	说明
code	integer	否	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。该音轨已转过 WAV 时返回 code 422，data 中带回已有结果的 taskId 与 audioWavUrl，不扣费。 可选值：200 / 401 / 402 / 404 / 409 / 422 / 429 / 451 / 455 / 500。 示例：200。
msg	string	否	当 code != 200 时的错误信息 示例：success。
data	object	否	—
data.taskId	string	否	任务ID，用于后续查询任务状态 示例：5c79****be8e。

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

回调

wavGenerated

回调地址：{$request.body#/callBackUrl}（即请求体里的 callBackUrl）。

当WAV格式音频生成完成时，系统会调用此回调通知结果。

回调示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "audio_wav_url": "https://example.com/s/04e6****e727.wav",
    "task_id": "988e****c8d3"
  }
}

回调体参数

参数	类型	必填	说明
code	integer	否	状态码 示例：200。
msg	string	否	返回消息 示例：success。
data	object	否	—
data.task_id	string	否	任务ID
data.audio_wav_url	string	否	WAV格式音频文件URL

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "",
    "audio_wav_url": "https://your-domain.com/input.png"
  }
}