Overview Quick Start API Reference Speech-to-Text API Text-to-Speech API

API Reference

Complete reference for the Doslarb Cloud REST API.

Authentication

Include your API key in the Authorization header as a Bearer token. All requests must use HTTPS.

Authorization: Bearer YOUR_API_KEY

POST/api/v1/transcribe

Transcribe Audio

Upload an audio file and receive Khmer and English transcripts.

Parameters

Name	Type	Required	Description
file	binary	Yes	Audio file in MP3, WAV, M4A, OGG, FLAC, or OPUS format
model	string	No	Model identifier. Default: ds-stt-v2

Response

json

{
  "text": "transcribed text here",
  "confidence": 0.95,
  "duration_seconds": 14.2,
  "model": "ds-stt-v2"
}

Examples

bash

curl -X POST https://doslarb.cloud/api/v1/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @audio.mp3

POST/api/v1/tts

Text to Speech

Convert Khmer or English text to speech. Returns raw MP3 audio (audio/mpeg).

Parameters

Name	Type	Required	Description
text	string	Yes	The text to synthesize. Up to 1200 characters on free plans, 20000 on paid.
voice	string	No	Voice slug: "sovann" (Sovann) or "puthi" (Puthi). Default: "sovann"

Examples

bash

curl -X POST https://doslarb.cloud/api/v1/tts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "សួស្តី! សូមស្វាគមន៍មកកាន់ Doslarb Cloud — បច្ចេកវិទ្យាបំប្លែងអក្សរទៅជាសម្លេងសម្រាប់ភាសាខ្មែរ។", "voice": "sovann"}' \
  --output speech.mp3

Error Codes

Status Code	Error Type	Description
400	invalid_request	Malformed request body or missing required fields
401	unauthorized	Missing or invalid API key
413	file_too_large	Audio file exceeds maximum size limit
415	unsupported_media_type	Audio format not supported
429	quota_exceeded	Monthly request or audio-minutes quota reached. Upgrade your plan to continue.
429	rate_limit_exceeded	Per-key rate limit exceeded. See Retry-After and X-RateLimit-* response headers.
503	service_unavailable	STT engine temporarily unavailable. Retry after delay.