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: tmrone-speech-v1

Response

json

{
  "text": "transcribed text here",
  "confidence": 0.95,
  "duration_seconds": 14.2,
  "model": "tmrone-speech-v1"
}

Examples

bash

curl -X POST https://tmrone.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

Coming Soon

The Text-to-Speech endpoint is under development. This section will be updated when it becomes available.

Parameters

Name	Type	Required	Description
text	string	Yes	The text to convert to speech
language	string	No	Language code: "km" (Khmer) or "en" (English). Default: "km"

Examples

bash

curl -X POST https://tmrone.cloud/api/v1/tts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "language": "en"}' \
  --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	monthly_limit_exceeded	Monthly plan limit reached. Upgrade to continue.
503	service_unavailable	STT engine temporarily unavailable. Retry after delay.