ឯកសារយោង API

ឯកសារយោងពេញលេញសម្រាប់ REST API របស់ Doslarb Cloud។

ការផ្ទៀងផ្ទាត់

បញ្ចូលកូនសោ API របស់អ្នកនៅក្នុង header Authorization ជា Bearer token។ រាល់សំណើទាំងអស់ត្រូវតែប្រើ 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

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://doslarb.cloud/api/v1/tts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "language": "en"}' \
  --output speech.mp3

កូដកំហុស

កូដស្ថានភាព	ប្រភេទកំហុស	ការពិពណ៌នា
400	invalid_request	តួសំណើខូចទ្រង់ទ្រាយ ឬខ្វះវាលដែលត្រូវការ
401	unauthorized	កូនសោ API បាត់ ឬមិនត្រឹមត្រូវ
413	file_too_large	ឯកសារសំឡេងលើសពីទំហំអតិបរមា
415	unsupported_media_type	ទម្រង់សំឡេងមិនត្រូវបានគាំទ្រ
429	quota_exceeded	បានឈានដល់ដែនកំណត់ផែនការប្រចាំខែ។ សូមតម្លើងកម្រិតដើម្បីបន្ត។
503	service_unavailable	ម៉ាស៊ីន STT មិនអាចប្រើបានបណ្ដោះអាសន្ន។ សូមព្យាយាមម្ដងទៀតក្រោយពេលបន្តិច។