Skip to main content
POST
Voice Capture
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/persona and the parameters inside input. Both behave and bill the same.
When the task succeeds, data.persona_id is the ID of the new voice. Pass it as persona_id when generating, covering or extending to sing with that voice.

Authorizations

Authorization
string
header
required

Send your API key in the Authorization: Bearer YOUR_API_KEY header.

Body

application/json
music_id
string
required

Source Track: The track to work on. Use the music_id from an earlier result.

name
string
required

Name: A name for the voice or model you are creating.

describe
string

Description: An optional note about this voice.

vocal_start_s
number

Vocal From: Where the vocal segment starts, in seconds. Provide together with Vocal To; the range must be shorter than 30 seconds.

Required range: x >= 0
vocal_end_s
number

Vocal To: Where the vocal segment ends, in seconds. Must be after Vocal From, and the range must be shorter than 30 seconds.

styles
string

Suited Styles: Styles this voice works well for.

notify_hook
string<uri>

Notify hook: when the task ends, the same content as the fetch result is POSTed to this URL (a public http / https URL). Omit it to poll instead.

Response

OK

code
enum<string>
required
Available options:
success
data
object
required
message
string