Troubleshooting & FAQ

Common questions and solutions for issues you might encounter.

Authentication Issues

"Invalid or missing API token" (401)

• Verify the key is in the Authorization header: Bearer vbt_your_key.
• Check the key hasn't been deleted from the API Keys page.
• If the key has an expiration date, verify it hasn't expired.
• Create a new API key if needed.

"You are not a member of this workspace" (403)

• Ask the workspace owner to invite you.
• Verify you're using the correct API key for the intended workspace.

Billing Issues

"Insufficient balance" (402)

• Go to Billing and add funds via manual top-up.
• Enable Auto Top-Up to prevent this in the future.
• Check your current balance on the Billing page.

Auto top-up is not working

• The saved payment method may have expired or been declined.
• The threshold may be set too low.
• There's a cooldown period between auto top-ups.
• Update your payment method and verify threshold/amount settings.

Voice Issues

Voice cloning failed

• Audio file too short (minimum 10 seconds required).
• Audio file too large (maximum 20 MB).
• Unsupported format (only .mp3 and .wav).
• Audio quality too poor — record in a quiet environment and enable noise reduction.

Cloned voice expired

Cloned voices expire after 7 days of inactivity. Verbatik sends keep-alive requests for active voices. If expired, clone it again with the same audio sample.

Voice design produced unexpected results

• Be more specific in your prompt (gender, age, accent, tone, personality).
• Try different prompt variations.
• Use preview text to test before committing.

Rate Limiting

"Rate limit exceeded" (429)

• Check the Retry-After header for when to retry.
• Implement exponential backoff in your code.
• Increase your rate limit from workspace settings (up to 10,000 requests per window).
• Set time window to 0 to disable rate limiting (use with caution).

Text-to-Speech Issues

"Text exceeds maximum length"

Split your text into multiple requests. Each can handle up to 25,000 characters with automatic chunking.

Audio quality is poor

• Use a neural voice (is_neural: true).
• For cloned voices, ensure the source audio was high quality.
• Try a different voice matching your language and use case.

SSML is not being processed

Set Content-Type: application/ssml+xml for SSML input.

Music Generation Issues

"Invalid input combination"

• Provide at least one of: prompt, tags, or lyrics.
• Lyrics alone are not sufficient — pair with prompt or tags.
• Tags alone are not sufficient — pair with prompt or lyrics.
• Do not provide all three simultaneously.

Music generation is slow

Music generation typically takes 30–90 seconds per track. This is normal.

Workspace Issues

Cannot create more workspaces

Maximum of 6 owned workspaces. Delete one you no longer need. Workspaces you're a member of don't count.

Cannot invite more members

Maximum of 3 members per workspace (including the owner). Remove an existing member to make room.

Invitation expired

Invitations expire after 24 hours. Resend from the Members page.

General FAQ

What audio formats does Verbatik support? MP3, WAV, and OGG for pre-trained voices. MP3, PCM, and FLAC for cloned voices. FLAC, MP3, WAV, OGG, and M4A for music generation.

Can I use Verbatik for commercial projects? Yes. Review the license terms on the Verbatik website for full details.

Is there an SDK or client library? Verbatik provides a REST API that works with any HTTP client. You can also connect via MCP for AI assistant integration.

How do I contact support? Email support@verbatik.com.

What happens to my data if I delete my account? All workspaces you own (voices, music, API keys, billing data) are permanently deleted. Your membership in other workspaces is removed.

Can I transfer workspace ownership? Contact support or use workspace settings if the option is available.

Are API calls logged? Yes. Usage is logged per API key with character counts, response times, and costs for analytics purposes.