verging-ai Speech-to-Text — verging.ai
Transcribe audio to text using OpenAI Whisper 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/stt
Content-Type: multipart/form-data
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| file | file | Yes | — | Audio file to transcribe |
| model | string | No | whisper-1 | STT model |
| language | string | No | — | Language code (e.g. en, zh, ja) |
| response_format | string | No | json | Output format |
| temperature | float | No | — | Sampling temperature (0–1) |
Supported Audio Formats
mp3, mp4, mpeg, mpga, m4a, wav, webm
File Size Limit
Maximum file size: 25 MB
Example
curl -X POST https://verging.ai/api/v1/ai/stt \
-H "Authorization: ApiKey vrg_sk_xxx" \
-F "file=@recording.mp3" \
-F "language=en"
Response
{
"text": "Hello, this is a sample transcription of the audio file.",
"language": "en",
"duration": 12.5,
"credits_consumed": 1
}
text— Transcribed text content.language— Detected or specified language.duration— Audio duration in seconds.credits_consumed— Credits deducted for this request.
Credits
| Rate | Minimum |
|---|---|
| 1 credit / minute | 1 credit |
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 400 | — | File exceeds 25 MB or unsupported audio format |
| 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: 1, available: 0",
"upstream_error": null
}