Create voice

After a successful submission, save data.jobId and use Retrieve a task to track the task.

After the task completes, the creation result is in data.data.data. name is the voice name, and persona_id is the generated Persona ID.

POST/suno/mj/submit/create-voice

Authorization

bearerAuth

AuthorizationBearer <token>

Authenticate with Authorization: Bearer your-api-key.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

audio_url*string

Publicly accessible MP3 or WAV audio URL.

hookUrl?string

Optional user callback URL. Only ports 80, 443, 8080, and 8443 are supported. When provided, the platform forwards notifications to it.

Response Body

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/create-voice' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "audio_url": "https://example.com/voice-reference.wav"
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "JOB_ID"
  }
}

Authorization

Request Body

Response Body

200application/json

`application/json`