| name | verging-ai-tts |
| description | Convert text to speech audio using OpenAI TTS-1-HD through the verging.ai proxy API. Supports multiple voices, playback speed control, and various audio output formats. |
Text-to-Speech — verging.ai
Convert text to speech audio using OpenAI TTS-1-HD through the verging.ai proxy API.
Authentication
All requests require an API key in the Authorization header:
Authorization: ApiKey vrg_sk_xxx
Replace vrg_sk_xxx with your verging.ai API key. You can generate one at https://verging.ai under your account settings.
Endpoint
POST https://verging.ai/api/v1/ai/tts
Content-Type: application/json
Parameters
| Parameter | Type | Required | Default | Description |
|---|
| input | string | Yes | — | Text to convert to speech (max 4096 characters) |
| voice | string | No | alloy | Voice to use (see options below) |
| model | string | No | tts-1-hd | TTS model |
| response_format | string | No | mp3 | Audio output format |
| speed | float | No | 1.0 | Playback speed (0.25–4.0) |
Available Voices
| Voice | Description |
|---|
| alloy | Neutral, balanced |
| echo | Warm, rounded |
| fable | Expressive, British |
| onyx | Deep, authoritative |
| nova | Friendly, upbeat |
| shimmer | Soft, gentle |
Example
curl -X POST https://verging.ai/api/v1/ai/tts \
-H "Authorization: ApiKey vrg_sk_xxx" \
-H "Content-Type: application/json" \
-d '{
"input": "Hello! Welcome to verging.ai, your AI services platform.",
"voice": "nova",
"speed": 1.1
}'
Response
{
"audio_url": "https://cdn.verging.ai/proxy/tts/abc123.mp3",
"credits_consumed": 1
}
audio_url — CDN URL of the generated audio file.credits_consumed — Credits deducted for this request.
Credits
| Rate | Minimum |
|---|
| 1 credit / 1K characters | 1 credit |
Error Codes
| HTTP Status | Error Code | Description |
|---|
| 400 | — | Input exceeds 4096 characters or invalid params |
| 402 | 40001 | Insufficient credits |
| 429 | — | Rate limit exceeded (check X-RateLimit-Reset) |
| 502 | — | Upstream provider error |
| 503 | — | Service unavailable or upstream timeout |
Error response format:
{
"error_code": 40001,
"message": "Insufficient credits. Required: 2, available: 0",
"upstream_error": null
}
