Developer API

REST · JSON

cấp key thủ công

Tài liệu tích hợp API lồng tiếng YouTube: tạo manifest, nhận audio theo mốc phụ đề và theo dõi tiến trình bằng SSE.

Đăng ký API key đang được cấp thủ công

Tính năng tự tạo API key hiện chưa hoạt động. Nếu bạn muốn dùng API hoặc gói Enterprise, vui lòng liên hệ trực tiếp đội ngũ Voxelle — sẽ được cấp key, hạn mức và tài liệu tích hợp riêng.

contact@voxelle.io.vnGửi email đăng ký

Base URL

http://127.0.0.1:8080

Cấu hình domain production qua NEXT_PUBLIC_BACKEND_URL.

Xác thực

Authorization: Bearer <API_KEY>

Key do đội ngũ cấp khi bạn đăng ký — không tự tạo trong trang này.

Tính phí

25đ / giây audio

Trừ theo segment thực tế đã phục vụ, không tính khoảng lặng.

Endpoint chính

Method	Path	Mô tả
POST	/v1/youtube/dubbing/manifest	Tạo phiên lồng tiếng, trả timeline + session_token
POST	/v1/youtube/dubbing/ensure-window	Báo playhead để dịch và render cuốn chiếu
GET	/v1/youtube/dubbing/stream/{session_token}	SSE nhận segment_ready / manifest_complete
GET	/v1/health	Kiểm tra trạng thái Rust Core, Sidecar và TTS

Mã mẫu tích hợp

# 1. Tạo phiên lồng tiếng cho video YouTube
curl -X POST http://127.0.0.1:8080/v1/youtube/dubbing/manifest \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "youtube_url": "https://www.youtube.com/watch?v=<VIDEO_ID>",
    "voice_id": "quangminh",
    "target_lang": "vi"
  }'

API key hiện được cấp thủ công. Nếu bạn cần sandbox, hạn mức riêng hoặc SLA, hãy liên hệ contact@voxelle.io.vn.