惯例
每个请求的结构。
一个基础 URL,一个 Bearer 标头,JSON 格式的输入与输出。密钥带有作用域(translate:write、jobs:read),路由需要匹配的作用域。账户、账单、团队、Webhook 和密钥管理位于应用 UI 中,而不是 API 中 —— 密钥无法生成密钥或更改账单。
基础 URLhttps://api.echo-lingua.com/v1
每个请求Authorization: Bearer elk_live_2b7f… Content-Type: application/json
参考 · 19 个端点
您可以使用密钥调用的端点。
点击任意端点查看其选项、请求与响应示例,以及可一键复制的 cURL、JS/TS、Python 和 PHP 代码。每个端点都显示其所需的作用域;GET /v1/health 是 公开 且无需认证。仪表盘专用和管理员操作不在此列 —— 它们需要登录会话,而不是密钥。
任务
批处理管道:创建任务、评估规模、观察进度,然后下载仓库结构打包文件。审校、重试失败项,或从源文件重新处理。
同步翻译
内联翻译代码片段中的字符串或字面量,无需轮询任务。按任务同等标准计费。
模板
从源文件生成每种语言的空白 PO 文件骨架,不进行翻译,不收取费用。
使用量与成本
以编程方式读取当前周期的使用量、消费金额和限额。
服务
用于状态检查和监控的公开存活探测接口。
读取费用
所有金额均以微美元(micro-USD)为单位。
API 中的金额是以微美元(百万分之一美元)为单位的整数计数,因此 1,000,000 即代表 1 美元。除以一百万即可换算为美元。使用整数意味着分钱的小数部分永远不会被舍入:一项小型作业的费用完全可能是几十分之一美分。
微美元 → 美元// Every *Micros field is an integer count of micro-USD (millionths of a dollar). const usd = (micros) => micros / 1_000_000; usd(52500); // 0.0525 → about 5¢ usd(322500); // 0.3225 → about 32¢ usd(1_000_000); // 1.00 → one dollar // Format it for display: const fmt = (micros) => new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }) .format(micros / 1_000_000); // fmt(52500) → "$0.05"
金额字段
chargedMicros — 一项作业或估价将从您的余额中扣除的金额。
creditRequiredMicros — 您开始一项作业所需的余额:费用加上一小部分安全预留额。
来自 GET /v1/usage 的使用总量使用相同的单位。
示例:chargedMicros 为 52500 时,结果是 $0.0525。