API dịch
Gửi tài liệu của bạn đến Edgepedia Translate bằng tập lệnh để nhận lại bản dịch. Đây cũng chính là dịch vụ trên trang Dịch, với cùng mức giá và dùng chung số điểm trong tài khoản.
Lấy khóa API
Tạo khóa trên trang Dịch: đăng nhập, mở mục tài khoản ở góc trên bên phải, rồi chọn Tạo trong mục Khóa API.
Gửi kèm khóa trong mọi yêu cầu dưới dạng Authorization: Bearer ept_…. Hãy giữ bí mật khóa này: bất kỳ ai có khóa đều có thể sử dụng điểm của bạn.
Giá
- Tiêu chuẩn: 1 điểm cho mỗi 250 từ (tối thiểu 1 điểm).
- Pro: 1 điểm cho mỗi 75 từ (tối thiểu 2 điểm).
- Khi dịch giữa hai ngôn ngữ đều không phải tiếng Anh, giá tăng gấp đôi.
- 100 điểm = 1 USD.
Nếu dịch thất bại, số điểm đã dùng sẽ được hoàn lại.
Các tuyến
URL cơ sở: https://translate.edgepedia.ai. Yêu cầu và phản hồi đều ở dạng JSON; lỗi có dạng {"error": "…"}.
GET /api/v1/languages
Danh sách ngôn ngữ, kèm thông tin có hỗ trợ Pro cho từng ngôn ngữ hay không.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
Số điểm của bạn.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
Giá và thời gian dự kiến cho một bản dịch, chưa bắt đầu dịch. mode là standard hoặc pro.
Yêu cầu báo giá cũng chấp nhận "source": "auto": phản hồi cho biết ngôn ngữ nhận diện được trong "source", qua "detected": true; sau đó dùng mã ngôn ngữ ấy để bắt đầu dịch.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
Bắt đầu dịch văn bản hoặc tệp .txt, .md, .docx hay .pdf tối đa 10 MB. Thêm "expect_credits" để yêu cầu bị từ chối (409) nếu giá không đúng như bạn dự kiến. Thêm "wait" (tối đa 120 giây) để nhận bản dịch hoàn chỉnh ngay trong cùng phản hồi.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
Trạng thái của bản dịch (queued, running, done hoặc failed) và nội dung bản dịch khi hoàn tất. Nếu dịch thất bại, phản hồi sẽ nêu lý do. Có thể lấy lại bản dịch đã hoàn tất trong vòng 30 ngày.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
Kết quả dịch tệp: tệp .docx cho các tệp .docx và .pdf, văn bản cho các tệp .txt và .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Các bản dịch của bạn, mới nhất trước, tối đa 50 bản.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Mã trạng thái
| Mã | Ý nghĩa |
|---|---|
| 200 | OK; với yêu cầu bắt đầu dịch có wait, bản dịch đã hoàn tất hoặc thất bại. |
| 202 | Đã bắt đầu, hoặc vẫn đang dịch sau thời gian wait. |
| 400 | Không thể dịch với yêu cầu được gửi như hiện tại; thông báo lỗi sẽ nêu lý do. |
| 401 | Thiếu khóa, khóa không được nhận diện hoặc đã bị thu hồi. |
| 402 | Không đủ điểm. |
| 404 | Không có bản dịch này trong tài khoản của bạn. |
| 409 | Giá không khớp với expect_credits của bạn; không có khoản phí nào được tính. |
| 413 | Tệp vượt quá 10 MB. |
| 429 | Quá 60 yêu cầu trong một phút; hãy thử lại sau số giây ghi trong Retry-After. |