Stt
DocumentssttStt is an Agent Skill for documents published in the aiskillstore/marketplace repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Transcribe audio to text using OpenAI Whisper through the verging.ai proxy API.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/aiskillstore/marketplace/blob/HEAD/skills/verging-ai/stt/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/stt, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 "[email protected]" \
-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
}