SunoAPI(通用)
    • 生成音乐
      POST
    • 生成音乐(V2)
      POST
    • 任务查询
      POST
    • 任务批量查询
      POST
    • 生成歌词
      POST
    • 优化提示词
      POST
    • 上报参考音乐(阻塞)
      POST
    • 上报参考音乐(异步)
      POST
    • 获取上报结果(异步)
      POST
    • 上报参考音乐(Deprecated)
      POST
    • 查询剩余积分
      POST
    • 查询服务状态
      POST
    • 获取创建人设验证语句
      POST
    • 创建人设
      POST
    • 获取人设
      POST
    • 查询人设是否已失效
      POST
    • 重新激活人设
      POST
    • 生成WAV
      POST
    • 获取WAV
      POST
    • 获取时间轴歌词
      POST
    • 获取波形数据
      POST
    • 生成MP4
      POST
    • 获取MP4
      POST
    • 开始分离
      POST
    • 查询分离状态
      POST
    • 生成MIDI
      POST
    • 获取MIDI
      POST
    • 临时token
      POST

      查询人设是否已失效

      POST
      https://suno.x-mi.cn/apiclouds/v1/suno/checkPersonaStatus
      因为新版的人设具有效性,一般有效期也就2天左右,为了方便管理人设,可用调用此接口查看是否有效。

      请求参数

      Header 参数

      Body 参数application/json

      示例
      {
        "clipIds": [
          "e33f7bf7-3916-407d-961d-e57b394eb635"
        ]
      }

      请求示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location 'https://suno.x-mi.cn/apiclouds/v1/suno/checkPersonaStatus' \
      --header 'x-apiid: 155007609383837293' \
      --header 'x-token: sk-BFC648DFDAF84AE994F78485BB130B3F' \
      --header 'Content-Type: application/json' \
      --data '{
        "clipIds": [
          "e33f7bf7-3916-407d-961d-e57b394eb635"
        ]
      }'

      返回响应

      🟢200成功
      application/json
      Bodyapplication/json

      示例
      {
          "code": 0,
          "msg": "OK",
          "data": [
              {
                  "clipId": "5d9d5a29-571d-4fe2-b7ae-1cea6a760ea7",
                  "isInvalid": 0
              }
          ],
          "success": true
      }
      修改于 2026-05-07 05:10:48
      上一页
      获取人设
      下一页
      重新激活人设
      Built with