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.apihubs.ru/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.apihubs.ru/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"
}
}