翻译 API
通过脚本将自己的文档发送至 Edgepedia 翻译,即可获取译文。它与翻译页面使用相同的服务,价格一致,并从同一账户的点数中扣费。
获取密钥
在翻译页面创建密钥:登录后,打开右上角的账户菜单,在“API 密钥”下选择“创建”。
每次请求都须通过 Authorization: Bearer ept_… 发送密钥。请妥善保密:任何持有此密钥的人都能消耗你的点数。
价格
- 标准:每 250 词 1 点(最低 1 点)。
- Pro:每 75 词 1 点(最低 2 点)。
- 两种非英语语言之间互译,价格翻倍。
- 100 点 = USD 1。
翻译失败将退还点数。
路由
基础 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
状态码
| 状态码 | 含义 |
|---|---|
| 200 | OK;以 wait 启动的翻译已完成或失败。 |
| 202 | 已启动,或在 wait 后仍在运行。 |
| 400 | 无法按当前请求进行翻译;错误信息会说明原因。 |
| 401 | 密钥缺失、无法识别或已撤销。 |
| 402 | 点数不足。 |
| 404 | 你的账户中没有此翻译。 |
| 409 | 价格与你的 expect_credits 不符;未收取任何费用。 |
| 413 | 文件超过 10 MB。 |
| 429 | 一分钟内请求超过 60 次;请按 Retry-After 给出的秒数等待后重试。 |