edgepedia dịch

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á

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
200OK; 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.
400Khô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.
401Thiếu khóa, khóa không được nhận diện hoặc đã bị thu hồi.
402Không đủ điểm.
404Không có bản dịch này trong tài khoản của bạn.
409Giá không khớp với expect_credits của bạn; không có khoản phí nào được tính.
413Tệp vượt quá 10 MB.
429Quá 60 yêu cầu trong một phút; hãy thử lại sau số giây ghi trong Retry-After.