▶สารบัญ API
เอกสาร Votxt OpenAPI
เบต้า Votxt OpenAPI ยังอยู่ในรุ่นเบต้า โปรดทดสอบการเชื่อมต่อในสภาพแวดล้อมพัฒนาก่อนใช้งานจริง
ภาพรวม
Votxt OpenAPI ช่วยเพิ่มการถอดเสียงจากเสียงและวิดีโอในแอปและเวิร์กโฟลว์อัตโนมัติ
อัปโหลดไฟล์หรือใช้ URL ไฟล์ภายนอก จากนั้นสร้างงานถอดเสียงและตรวจสอบสถานะ
เมื่อเสร็จแล้ว คุณสามารถส่งออกข้อความถอดเสียง คำบรรยาย และข้อมูลแบบมีโครงสร้างได้หลายรูปแบบ
URL พื้นฐาน
https://api.votxt.coการยืนยันตัวตน
ส่งคีย์ API ในส่วนหัวของคำขอ การเข้าถึง API ต้องใช้แพ็กเกจที่เปิดใช้งาน API
X-API-Key: your_api_key_here- เปิดการตั้งค่าบัญชี
- ตรวจสอบว่าแพ็กเกจของคุณมีการเข้าถึง API
- สร้างคีย์ API และเก็บไว้อย่างปลอดภัย
อัปโหลดไฟล์
ใช้อัปโหลดโดยตรงผ่าน URL ที่ลงนามแล้ว หรือระบุ URL ไฟล์ภายนอกแบบสาธารณะ
POST /api/v1/files/upload-urlPUT upload_urlPOST /api/v1/transcriptions
POST /api/v1/files/upload-url
Content-Type: application/json
X-API-Key: your_api_key
{
"filename": "audio.mp3",
"file_size": 1048576,
"upload_expires_in": 3600,
"download_expires_in": 1800
}ถอดเสียง
| Endpoint | เมธอด | คำอธิบาย |
|---|---|---|
| /api/v1/transcriptions | POST | อัปโหลดไฟล์ |
| /api/v1/transcriptions/youtube | POST | YouTube |
| /api/v1/transcriptions | GET | รายการถอดเสียง |
| /api/v1/transcriptions/{id} | GET | ถอดเสียง |
| /api/v1/transcriptions/{id}/status | GET | สถานะ |
POST /api/v1/transcriptions
Content-Type: application/json
X-API-Key: your_api_key
{
"file_key": "12345-abc123def456.mp3",
"filename": "audio.mp3",
"language_code": "en",
"transcription_type": "transcript",
"enable_speaker_diarization": false,
"webhook_url": "https://your-app.com/webhook"
}สถานะ
| สถานะ | ถอดเสียง |
|---|---|
| queued | รอคิว |
| preprocessing | เตรียมประมวลผล |
| processing | กำลังประมวลผล |
| completed | เสร็จสิ้น |
| failed | ล้มเหลว |
ส่งออก
เมื่อเสร็จแล้ว คุณสามารถส่งออกข้อความถอดเสียง คำบรรยาย และข้อมูลแบบมีโครงสร้างได้หลายรูปแบบ
| ส่งออก | รูปแบบ |
|---|---|
| ส่งออก | TXT |
| ส่งออก | SRT |
| ส่งออก | VTT |
| ส่งออก | JSON |
| ส่งออก | MD |
| ส่งออก | CSV |
| ส่งออก | DOCX |
| ส่งออก |
รูปแบบ
- รูปแบบเสียง: mp3, mpeg, mpga, m4a, wav, aac, ogg, opus, flac
- รูปแบบวิดีโอ: mp4, webm, mov
- ขนาดไฟล์สูงสุด: ขนาดสูงสุด: 5GB ต่อไฟล์
ภาษา
Votxt รองรับภาษาถอดเสียงจำนวนมาก ให้ส่งรหัสภาษาในคำขอ
| ภาษา | รหัส | ภาษา | รหัส | ภาษา | รหัส |
|---|---|---|---|---|---|
| Afrikaans | af | Gujarati (ગુજરાતી) | gu | Polish (Polski) | pl |
| Arabic (العربية) | ar | Hebrew (עברית) | he | Portuguese (Português) | pt |
| Azerbaijani (Azərbaycan) | az | Hindi (हिन्दी) | hi | Romanian (Română) | ro |
| Belarusian (Беларуская) | be | Croatian (Hrvatski) | hr | Russian (Русский) | ru |
| Bulgarian (Български) | bg | Haitian Creole (Kreyòl ayisyen) | ht | Slovak (Slovenčina) | sk |
| Bengali (বাংলা) | bn | Hungarian (Magyar) | hu | Slovenian (Slovenščina) | sl |
| Bosnian (Bosanski) | bs | Indonesian (Bahasa Indonesia) | id | Albanian (Shqip) | sq |
| Catalan (Català) | ca | Italian (Italiano) | it | Serbian (Српски) | sr |
| Czech (Čeština) | cs | Japanese (日本語) | ja | Swedish (Svenska) | sv |
| Welsh (Cymraeg) | cy | Kazakh (Қазақ) | kk | Swahili (Kiswahili) | sw |
| Danish (Dansk) | da | Kannada (ಕನ್ನಡ) | kn | Tamil (தமிழ்) | ta |
| German (Deutsch) | de | Korean (한국어) | ko | Telugu (తెలుగు) | te |
| Greek (Ελληνικά) | el | Lithuanian (Lietuvių) | lt | Thai (ไทย) | th |
| English | en | Latvian (Latviešu) | lv | Tagalog (Tagalog/Filipino) | tl |
| Spanish (Español) | es | Macedonian (Македонски) | mk | Turkish (Türkçe) | tr |
| Estonian (Eesti) | et | Malayalam (മലയാളം) | ml | Ukrainian (Українська) | uk |
| Basque (Euskara) | eu | Marathi (मराठी) | mr | Urdu (اردو) | ur |
| Persian (فارسی) | fa | Malay (Bahasa Melayu) | ms | Vietnamese (Tiếng Việt) | vi |
| Finnish (Suomi) | fi | Dutch (Nederlands) | nl | Chinese (Cantonese) (粵語) | yue |
| French (Français) | fr | Norwegian (Norsk) | no | Chinese (Simplified) (中文 简体) | zh |
| Galician (Galego) | gl | Punjabi (ਪੰਜਾਬੀ) | pa | Chinese (Taiwanese Mandarin) (國語) | zh_tw |