跳转到主要内容
POST
/
api
/
v1
/
voice
/
check-voice
Suno Voice检查是否可用接口
curl --request POST \
  --url https://api.example.com/api/v1/voice/check-voice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "task_id": ""
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "isAvailable": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sunoapi.org/llms.txt

Use this file to discover all available pages before exploring further.

​
使用指南

  • 请在自建音色生成任务成功后调用此接口。
  • 在 task_id 中提交相关任务 ID。
  • 如果 isAvailable 为 true，表示该音色已可用于支持的 Suno 生成流程。

​
使用场景

当你准备发起依赖自建音色的生成请求前，可以先调用此接口确认音色是否可用，避免在音色尚不可用时提交后续任务。

​
相关接口

获取自建音色记录

检查可用性前，先查询最新任务状态和生成的音色信息

授权

​
Authorization
string
header
必填

API 认证说明

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

注意：

  • 请妥善保管您的 API Key，不要泄露给他人
  • 如果怀疑 API Key 泄露，请立即在管理页面重置

请求体

application/json
​
task_id
string
必填

需要检查的任务ID

响应

200 - application/json
​
code
integer
必填
​
msg
string
必填
​
data
object
必填