Skip to main content

​
Authentication

The VoiceCheap API uses API keys for authentication. All API requests must include your API key in the x-api-key header.

​
Getting Your API Key

1

Sign in to VoiceCheap

Go to app.voicecheap.ai and sign in to your account.
2

Navigate to API Page

Go to the API page at app.voicecheap.ai/page-api.
3

Generate API Key

Click Create New Key and give your key a name. Your full API key will be displayed only once - copy and securely store it immediately.
Important: Save Your Key ImmediatelyYour full API key is displayed only once when created. After closing the modal, you will only see a masked version (vc_abc...xyz). If you lose your key, you must delete it and create a new one.

​
API Key Limits

  • You can create a maximum of 5 API keys per account
  • Each key can be named for easy identification (e.g., “Production”, “Development”)
  • Keys can be deleted at any time from the API page

​
Using Your API Key

Include your API key in the x-api-key header with every request: 
curl -X POST https://api.voicecheap.ai/v1/translate \
  -H "x-api-key: vc_your-api-key-here" \
  -F "file=@video.mp4" \
  -F "targetLanguage=spanish"

​
Requirements

Paid Subscription RequiredAPI access requires an active paid subscription. Free accounts cannot use the API. If you attempt to use the API without a valid subscription, you will receive a 403 Forbidden error.

​
API Key Security

Keep it Secret

Never expose your API key in client-side code, public repositories, or any publicly accessible location.

Use Environment Variables

Store your API key in environment variables or a secure secrets manager.

Rotate Regularly

Periodically rotate your API keys, especially if you suspect they may have been compromised.

Monitor Usage

Keep track of your API usage to detect any unauthorized access.

​
Error Responses

If authentication fails, you will receive one of the following errors:
Status CodeError CodeDescription
401INVALID_API_KEYThe provided API key is invalid or missing
403SUBSCRIPTION_REQUIREDAPI access requires an active paid subscription
403INSUFFICIENT_CREDITSYour account does not have enough credits for this operation

​
Example Error Response

{
  "code": "INVALID_API_KEY",
  "message": "The provided API key is invalid. Please check your API key and try again."
}