▶Mục lục API

Tài liệu Votxt OpenAPI

Beta Votxt OpenAPI đang ở bản beta. Hãy kiểm thử tích hợp trong môi trường phát triển trước khi dùng sản xuất.

Tổng quan

Votxt OpenAPI giúp tích hợp chuyển văn bản âm thanh và video vào ứng dụng hoặc quy trình tự động.

Tải tệp lên hoặc dùng URL tệp bên ngoài, sau đó tạo tác vụ chuyển văn bản và kiểm tra trạng thái.

Khi hoàn tất, xuất bản ghi, phụ đề và dữ liệu có cấu trúc ở nhiều định dạng.

URL gốc

https://api.votxt.co

Xác thực

Gửi khóa API trong header của yêu cầu. Quyền truy cập API cần gói đang hoạt động có hỗ trợ API.

X-API-Key: your_api_key_here

Mở cài đặt tài khoản.
Xác nhận gói của bạn có quyền truy cập API.
Tạo khóa API và lưu trữ an toàn.

Tải tệp lên

Dùng tải trực tiếp với URL đã ký hoặc cung cấp URL tệp bên ngoài công khai.

POST /api/v1/files/upload-url
PUT upload_url
POST /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
}

Chuyển văn bản

Endpoint	Phương thức	Mô tả
/api/v1/transcriptions	POST	Tải tệp lên
/api/v1/transcriptions/youtube	POST	YouTube
/api/v1/transcriptions	GET	Bản chép lời
/api/v1/transcriptions/{id}	GET	Bản chép lời
/api/v1/transcriptions/{id}/status	GET	Trạng thái

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"
}

Trạng thái

Trạng thái	Chuyển văn bản
queued	Trong hàng đợi
preprocessing	Tiền xử lý
processing	Đang xử lý
completed	Hoàn tất
failed	Thất bại

Xuất dữ liệu