下载 MP3

下载 MP3

curl --request POST \
  --url https://apistable.com/api/v1/tasks/create_task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno_export_mp3",
  "input": {
    "audio_id": "YOUR_AUDIO_ID"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({model: 'suno_export_mp3', input: {audio_id: 'YOUR_AUDIO_ID'}})
};

fetch('https://apistable.com/api/v1/tasks/create_task', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apistable.com/api/v1/tasks/create_task"

payload = {
    "model": "suno_export_mp3",
    "input": { "audio_id": "YOUR_AUDIO_ID" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "<string>"
  }
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

POST

api

tasks

create_task

下载 MP3

curl --request POST \
  --url https://apistable.com/api/v1/tasks/create_task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno_export_mp3",
  "input": {
    "audio_id": "YOUR_AUDIO_ID"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({model: 'suno_export_mp3', input: {audio_id: 'YOUR_AUDIO_ID'}})
};

fetch('https://apistable.com/api/v1/tasks/create_task', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apistable.com/api/v1/tasks/create_task"

payload = {
    "model": "suno_export_mp3",
    "input": { "audio_id": "YOUR_AUDIO_ID" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "<string>"
  }
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

{
  "code": 123,
  "msg": "<string>",
  "data": null
}

能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务；音乐积分扣除当前未启用。

调用步骤

需要 MP3 文件时使用此操作；歌曲试听地址可能是 M4A。

1. 按下方示例准备输入，将占位地址和 ID 换成你有权使用的资源。
1. 将 model 设为 suno_export_mp3，参数放在 input 内。提交一次并保存返回的 task_id。
1. 查询已保存的任务，或接收回调。任务仍在处理中时继续等待，不重新提交同一操作。
从 result 读取 download_url，在 expires_at 前保存文件。复用已有导出不会重置有效期。

创建任务

将model和input发送到统一任务入口；可在顶层传公开HTTPS callback_url。资源ID均为本账户的本站ID。当前音乐积分扣除未启用。

{
  "model": "suno_export_mp3",
  "input": {
    "audio_id": "YOUR_AUDIO_ID"
  }
}

受理响应

HTTP 200仅表示受理。查询GET /api/v1/tasks/{task_id}，直到data.status为succeeded或failed。成功后读取data.result；失败原因位于data.message。

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "YOUR_TASK_ID"
  }
}

参数速查

字段	类型	必填	说明与限制
audio_id	string	是	本账户的本站歌曲ID。翻唱/续写只传此ID，不传源task_id或外部URL。 maxLength: 200

输入与限制

下方Schema列出支持字段、类型和基础限制；还须遵守“重要条件”，跨字段与来源资源校验不完全体现在JSON Schema中。未知参数会被拒绝。URL 参数仅接受公开 HTTPS 地址，不接受文件对象。

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "audio_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "本账户的本站歌曲ID。翻唱/续写只传此ID，不传源task_id或外部URL。"
    }
  },
  "required": [
    "audio_id"
  ],
  "additionalProperties": false
}

重要条件

源文件已经是MP3时可复用原文件，但不延长其到期时间。M4A会通过导出操作转换，修改扩展名并不能转换格式。
上传文件保留24小时，生成文件保留14天，任务详情保留30天；复用文件沿用原到期时间。有效Voice/Persona身份映射与任务日志清理分开处理，请及时下载需长期保存的文件。

结果 Schema

创建响应为 {code:200,msg:“success”,data:{task_id}}，轮询 GET /api/v1/tasks/{task_id}。成功时 data.result 为符合下方 Schema 的对象，其他状态为 null；input 仍为 JSON 字符串。

{
  "type": "object",
  "required": [
    "audio_id",
    "download_url",
    "expires_at"
  ],
  "properties": {
    "audio_id": {
      "type": "string"
    },
    "download_url": {
      "type": "string"
    },
    "expires_at": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

开始使用 APIstable（必读）

模型市场

调用步骤

创建任务

受理响应

参数速查

输入与限制

重要条件

结果 Schema

相关流程

授权

请求体

响应

​调用步骤

​创建任务

​受理响应

​参数速查

​输入与限制

​重要条件

​结果 Schema

​相关流程

授权

请求体

响应

调用步骤

创建任务

受理响应

参数速查

输入与限制

重要条件

结果 Schema

相关流程