Suno · Music

Voice PersonaNEW

📌 What is this：Extract a "voice persona" from a song to sing other songs later.

💡 When to use：Use to reuse one voice across multiple songs.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/suno
Query Result	GET	/api/cqt/info/suno?id={taskId}

Request Parameters

Param	Type	Required	Description
task	string	Required	Fixed value: persona
clipId	string	Required	Source clip ID providing the voice
name	string	Required	Persona name
description	string	—	Persona description, e.g. "soulful R&B voice"
is_public	bool	—	Whether the persona is public, default false
persona_type	string	—	Persona type, e.g. vox (voice)
vox_audio_id	string	—	Vox audio ID (source for extracting the voice)
vocal_start_s	number	—	Vocal segment start (seconds)
vocal_end_s	number	—	Vocal segment end (seconds)
user_input_styles	string	—	Style description, e.g. "soulful vocals, R&B, smooth harmonies"

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "task":"persona", "clipId":"6e1f9e23-09f6-43d2-812a-59a154459082", "name":"My Vocal Persona", "description":"A soulful R&B voice", "is_public":true, "persona_type":"vox", "vox_audio_id":"373efa9c-a366-42bb-806c-afdfc9b306a7", "vocal_start_s":16.13, "vocal_end_s":46.13, "user_input_styles":"soulful vocals, R&B, smooth harmonies" }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "692bc16760a940bfbe0d450cdcf7b69e",
    "taskType": "persona",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "persona",
      "clipId": "6e1f9e23-09f6-43d2-812a-59a154459082",
      "name": "My Vocal Persona",
      "description": "A soulful R&B voice",
      "is_public": true,
      "persona_type": "vox",
      "vox_audio_id": "373efa9c-a366-42bb-806c-afdfc9b306a7",
      "vocal_start_s": 16.13,
      "vocal_end_s": 46.13,
      "user_input_styles": "soulful vocals, R&B, smooth harmonies"
    },
    "result": {
      "id": "65db3557-9864-4625-b237-b715ca0bb951",
      "name": "My Vocal Persona",
      "description": "A soulful R&B voice",
      "image_s3_id": "https://cdn2.suno.ai/image_6e1f9e23-09f6-43d2-812a-59a154459082.jpeg",
      "root_clip_id": "6e1f9e23-09f6-43d2-812a-59a154459082",
      "clip": {
        "status": "complete",
        "title": "Książę z Mroczną Przeszłością",
        "id": "6e1f9e23-09f6-43d2-812a-59a154459082",
        "entity_type": "song_schema",
        "audio_url": "https://cdn1.suno.ai/6e1f9e23-09f6-43d2-812a-59a154459082.mp3",
        "video_url": "https://cdn1.suno.ai/6e1f9e23-09f6-43d2-812a-59a154459082.mp4",
        "image_url": "https://cdn2.suno.ai/image_6e1f9e23-09f6-43d2-812a-59a154459082.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_6e1f9e23-09f6-43d2-812a-59a154459082.jpeg",
        "major_model_version": "v4",
        "model_name": "chirp-v4",
        "metadata": {
          "tags": "male,powerful, gritty, epic",
          "type": "gen",
          "duration": 202.68,
          "stream": true,
          "make_instrumental": false,
          "control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
          "can_remix": true,
          "is_remix": false
        },
        "user_id": "f04d4d05-dd5c-4f54-ac37-3357099b2ce1",
        "display_name": "ernabillstbwsd",
        "handle": "ernabillstbwsd",
        "created_at": "2026-07-08T06:28:41.038Z",
        "is_public": false,
        "batch_index": 0
      },
      "user_display_name": "ernabillstbwsd",
      "user_handle": "ernabillstbwsd",
      "user_image_url": "https://cdn1.suno.ai/sAura10.jpg",
      "persona_clips": [
        { "id": 350960734, "clip": { "id": "6e1f9e23-09f6-43d2-812a-59a154459082", "status": "complete", "title": "Książę z Mroczną Przeszłością", "audio_url": "https://cdn1.suno.ai/6e1f9e23-09f6-43d2-812a-59a154459082.mp3" } }
      ],
      "is_owned": true,
      "is_public": true,
      "upvote_count": 0,
      "clip_count": 1,
      "persona_type": "vox",
      "source": "generated_clip",
      "user_input_styles": "soulful vocals, R&B, smooth harmonies",
      "vocal_start_s": 0.1,
      "vocal_end_s": 30,
      "vocal_clip_id": "95667adc-571f-4cc5-8624-d654d67c1f4d"
    },
    "createTime": "2026-07-08 14:31:59",
    "completeTime": "2026-07-08 14:32:15"
  }
}

Response Fields

Field	Type	Description
code	number	Status code; 200 = success
msg	string	Message
data.id	string	Task ID (the taskId returned on submit; used to poll)
data.taskType	string	Task type; always "persona"
data.status	string	Status: pending / succeeded / failed
data.errorMsg	string	Failure reason; empty on success
data.param	object	Echo of the request params you submitted
data.result	object	⚠ An object (NOT an array): the extracted voice persona
data.result.id	string	Persona ID; reference this voice in later creations
data.result.name / description	string	Persona name / description
data.result.persona_type	string	Persona type, e.g. vox (voice)
data.result.root_clip_id	string	Source song clip ID
data.result.clip	object	Full source clip info (audio_url / video_url / image_url / metadata…)
data.result.persona_clips	array	Clips that use this persona
data.result.vocal_start_s / vocal_end_s	number	Sampled vocal range (seconds)
data.createTime / completeTime	string	Task submit time / completion time

Billing & Credits

5 credits (x your user rate). Auto-refunded on failure.