文档

API 参考。

您可以使用 API 密钥调用的每个端点,均生成自 API 所路由的同一清单,并提供针对实时架构验证过的完整请求和响应示例。从端到端流程的 开发者快速入门 开始。

正在使用 JavaScript 或 TypeScript 进行开发?您可能根本不需要原生 API。 查看包 →

惯例

每个请求的结构。

一个基础 URL,一个 Bearer 标头,JSON 格式的输入与输出。密钥带有作用域(translate:write、jobs:read),路由需要匹配的作用域。账户、账单、团队、Webhook 和密钥管理位于应用 UI 中,而不是 API 中 —— 密钥无法生成密钥或更改账单。

基础 URL
https://api.echo-lingua.com/v1
每个请求
Authorization: Bearer elk_live_2b7f…
Content-Type: application/json
参考 · 19 个端点

您可以使用密钥调用的端点。

点击任意端点查看其选项、请求与响应示例,以及可一键复制的 cURL、JS/TS、Python 和 PHP 代码。每个端点都显示其所需的作用域;GET /v1/health 是 公开 且无需认证。仪表盘专用和管理员操作不在此列 —— 它们需要登录会话,而不是密钥。

任务

批处理管道:创建任务、评估规模、观察进度,然后下载仓库结构打包文件。审校、重试失败项,或从源文件重新处理。

同步翻译

内联翻译代码片段中的字符串或字面量,无需轮询任务。按任务同等标准计费。

模板

从源文件生成每种语言的空白 PO 文件骨架,不进行翻译,不收取费用。

使用量与成本

以编程方式读取当前周期的使用量、消费金额和限额。

服务

用于状态检查和监控的公开存活探测接口。

已显示 19 个端点中的 19 个
读取费用

所有金额均以微美元(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。

将其接入您的流水线。

创建一个带作用域的密钥,POST 一个任务,然后让签名的 Webhook 告诉你它完成了。

阅读开发者指南