Suno: voice

Create a reusable voice or persona.

Action facts

Property	Value
Model	`suno`
Action	`voice`
Endpoint	`POST /api/v1/generation/create`
Result	`output` structured data
Pricing	View current pricing

Minimal request


curl -X POST https://api.api-stock.com/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno",
  "input": {
    "action": "voice",
    "voiceAudioUrl": "https://example.com/voice.mp3"
  }
}'


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Parameters

Parameter	Type	Required	Default	Description
`action`	“music” \| “extend” \| “cover” \| “add-instrumental” \| “add-vocals” \| “sound” \| “stems” \| “stems-all” \| “wav” \| “lyrics” \| “voice” \| “timestamped-lyrics” \| “boost-style” \| “music-cover” \| “replace-section” \| “music-video” \| “inspo” \| “upload” \| “remaster” \| “add-stem” \| “vox” \| “remove-section” \| “crop” \| “fade-in” \| “fade-out” \| “adjust-speed” \| “concat” \| “mashup” \| “sample” \| “midi” \| “bpm”	Yes	`"music"`	Suno operation
`sourceTaskId`	string	No	—	Reference to one of your prior Suno generations (its taskId), used by stateful actions such as extend, music-cover, replace-section, timestamped-lyrics, music-video, voice and wav.
`startS`	number	No	—	Start time (seconds) of the affected range. Used by remove-section / crop / sample (the range), replace-section (the infill range) and vox / voice-from-track (the vocal window).
`endS`	number	No	—	End time (seconds) of the affected range (> startS). See startS for the actions that use it.
`voiceAudioUrl`	string	Yes	—	voice: URL to the voice recording
`verificationAudioUrl`	string	No	—	voice: URL to the verification-phrase recording
`phraseId`	string	No	—	voice: phrase ID from the verification-phrase endpoint
`name`	string	No	—	voice: voice name
`description`	string	No	—	voice: description
`styles`	string	No	—	voice: genre tags (e.g. ‘funk edm’)
`singerSkillLevel`	“Beginner” \| “Intermediate” \| “Advanced” \| “Professional”	No	—	voice: singer skill level
`voxAudioId`	string	No	—	voice (persona from a track): id obtained from a prior vox extraction; the startS/endS must match that vox’s clip range.

Conditional rules: Requires voiceAudioUrl or sourceTaskId. A track source also requires name; verification requires verificationAudioUrl, phraseId, and name together.

Only send fields relevant to this action. When a request references sourceTaskId, the source must be a successful Suno task owned by the same account.

Result


curl https://api.api-stock.com/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

You can instead provide a top-level webhook. The task reaches finished, failed or expired; failed generations are refunded automatically. Data actions return output, while media actions return files.


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "output": {},
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

Back to all Suno actions