edgepedia 翻译

翻译 API

通过脚本将自己的文档发送至 Edgepedia 翻译,即可获取译文。它与翻译页面使用相同的服务,价格一致,并从同一账户的点数中扣费。

获取密钥

在翻译页面创建密钥:登录后,打开右上角的账户菜单,在“API 密钥”下选择“创建”。

每次请求都须通过 Authorization: Bearer ept_… 发送密钥。请妥善保密:任何持有此密钥的人都能消耗你的点数。

价格

翻译失败将退还点数。

路由

基础 URL:https://translate.edgepedia.ai。请求和响应均为 JSON 格式;错误格式为 {"error": "…"}。

GET /api/v1/languages

语言列表,以及每种语言是否支持 Pro 模式。

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages

GET /api/v1/balance

你的点数余额。

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance

POST /api/v1/quote

获取翻译价格和预计用时,不启动翻译。mode 为 standard 或 pro。

报价请求也接受 "source": "auto":响应通过 "detected": true 返回在 "source" 中检测到的语言,随后使用该语言代码启动翻译。

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

启动翻译,可提交文本,或不超过 10 MB 的 .txt、.md、.docx 或 .pdf 文件。添加 "expect_credits" 后,若价格与预期不符,请求将被拒绝(409)。添加 "wait"(最长 120 秒),可在同一次响应中获取完成的译文。

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}

翻译状态(queued、running、done 或 failed),完成后还会返回译文。失败时会说明原因。已完成的译文可在 30 天内获取。

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID

GET /api/v1/translations/{id}/download

文件翻译的结果:.docx 和 .pdf 文件返回 .docx,.txt 和 .md 文件返回文本。

curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download

GET /api/v1/translations

你的翻译记录,按从新到旧排列,最多 50 条。

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations

状态码

状态码含义
200OK;以 wait 启动的翻译已完成或失败。
202已启动,或在 wait 后仍在运行。
400无法按当前请求进行翻译;错误信息会说明原因。
401密钥缺失、无法识别或已撤销。
402点数不足。
404你的账户中没有此翻译。
409价格与你的 expect_credits 不符;未收取任何费用。
413文件超过 10 MB。
429一分钟内请求超过 60 次;请按 Retry-After 给出的秒数等待后重试。