Authentication

All API requests to Verbatik AI require authentication using your API key.

API Key

Your API key is a secret credential that identifies your account and authorizes API requests. You can find your API key in your Verbatik AI dashboard.

Security Best Practices

• Keep your API key secret: Never expose it in client-side code or public repositories
• Use environment variables: Store your API key in environment variables
• Rotate regularly: Generate new API keys periodically for security
• Monitor usage: Regularly check your API usage in the dashboard

Authentication Methods

HTTP Header (Recommended)

Include your API key in the Authorization header:

curl -X POST https://api.verbatik.com/v1/text-to-speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, world!",
    "voice": "en-US-Neural2-F"
  }'

JavaScript/TypeScript SDK

import { VerbatikAI } from '@verbatik/ai';

const verbatik = new VerbatikAI(process.env.VERBATIK_API_KEY);

Python SDK

from verbatik_ai import VerbatikAI
import os

verbatik = VerbatikAI(os.getenv('VERBATIK_API_KEY'))

Error Responses

If authentication fails, you'll receive a 401 Unauthorized response:

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key"
  }
}

Rate Limits

API keys have rate limits based on your plan:

• Free: 100 requests/hour
• Pro: 1,000 requests/hour
• Enterprise: Custom limits

Rate limit headers are included in all responses:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

Next Steps

• Learn about API endpoints
• Check rate limits
• Explore error handling