docs.api.box
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Suno API
Common APIFile Upload API
Suno API
Common APIFile Upload API
  1. Suno Voice
  • API.box Documentation
  • Quick Start
  • Generate Music
    • Music Generation Callbacks
    • Music Extension Callbacks
    • Upload and Cover Audio Callbacks
    • Upload and Extend Audio Callbacks
    • Add Instrumental Callbacks
    • Add Vocals Callbacks
    • Music Cover Generation Callbacks
    • Replace Music Section Callbacks
    • Generate Music
      POST
    • Extend Music
      POST
    • Upload And Cover Audio
      POST
    • Upload And Extend Audio
      POST
    • Add Instrumental
      POST
    • Add Vocals
      POST
    • Get Music Generation Details
      GET
    • Recovery Audio
      POST
    • Get Recovery Audio Details
      GET
    • Get Timestamped Lyrics
      POST
    • Boost Music Style
      POST
    • Generate Music Cover
      POST
    • Replace Music Section
      POST
    • Get Music Cover Details
      GET
    • Generate Persona
      POST
    • Generate Mashup
      POST
  • Suno Voice
    • Suno Voice Validation Phrase Callbacks
    • Suno Voice Generation Callbacks
    • Suno Voice Regenerate Phrase Callbacks
    • Suno Voice Generate Verification Phrase
      POST
    • Suno Voice Get Verification Phrase
      GET
    • Suno Voice Create Custom Voice
      POST
    • Suno Voice Get Custom Voice Record
      GET
    • Suno Voice Regenerate Verification Phrase
      POST
    • Suno Voice Check Availability
      POST
  • Lyrics Generation
    • Lyrics Generation Callbacks
    • Generate Lyrics
    • Get Lyrics Generation Details
  • Generate Sounds
    • Generate Sounds
  • WAV Conversion
    • WAV Format Conversion Callbacks
    • Convert to WAV Format
    • Get WAV Conversion Details
  • Vocal Removal
    • Audio Separation Callbacks
    • MIDI Generation Callbacks
    • Vocal and Instrument Separation
    • Get Audio Separation Details
    • Generate MIDI from Audio
    • Get MIDI Generation Details
  • Music Video Generation
    • Music Video Generation Callbacks
    • Create Music Video
    • Get Music Video Details
  • Generate Speech
    • Generate Speech
  1. Suno Voice

Suno Voice Generate Verification Phrase

POST
/api/v1/voice/validate
Generate the validation phrase required for the Suno Voice custom voice workflow.

Usage Guide#

Submit the source recording URL and the vocal segment you want to use for voice creation.
The API returns a taskId; use it to query the generated validation phrase.
When callBackUrl is provided, the system sends a POST callback when the phrase is ready or the task fails. The callback URL must be publicly accessible and return HTTP 200 within 15 seconds.
After receiving validateInfo, ask the user to record the phrase and upload the verification audio to the voice generation API. For best voice generation results, singing is recommended.

Workflow#

1.
Upload or host the source audio and make sure voiceUrl is publicly accessible.
2.
Choose a clean vocal segment with vocalStartS and vocalEndS.
3.
Submit the validation phrase task and store the returned taskId.
4.
Wait for validateInfo through the query API or callback.
5.
Record the user performing the validation phrase, then call the custom voice generation API. For best voice generation results, singing is recommended.

Callback#

Validation Phrase Callbacks
Learn the callback payload sent when the validation phrase is ready or the task fails

Developer Notes#

vocalEndS must be greater than vocalStartS.
Use a segment with clear speech and minimal background noise for better validation.
language controls the validation phrase language. Supported values include en, zh, es, fr, pt, de, ja, ko, hi, and ru.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://apibox.erweima.ai/api/v1/voice/validate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "voiceUrl": "https://example.com/audio/user_voice.mp3",
    "vocalStartS": 0,
    "vocalEndS": 10,
    "language": "en",
    "callBackUrl": "https://example.com/callback/suno/voice_prepare"
}'
Response Response Example
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "xxx_task_id_xxx"
    }
}
Previous
Suno Voice Regenerate Phrase Callbacks
Next
Suno Voice Get Verification Phrase
Built with