开发者 · Translay

API 密钥

…

快速开始

在上方创建密钥，并作为 Bearer 令牌发送。每次请求从余额中扣除字符，请求失败时自动退还。

curl https://api.translay.app/v1/translate \
  -H "Authorization: Bearer tr_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Where meaning travels intact.",
    "source_language": "auto",
    "target_language": "ru",
    "mode": "quality"
  }'

请求

响应包含译文、所用模型、令牌用量，以及文本被拆分的段数。

field	type	notes
`text`	string	required, up to 100,000 characters
`target_language`	string	required, ISO code or language name
`source_language`	string	optional, default `auto`
`mode`	`fast` \| `quality`	optional, default `fast`
`stream`	boolean	optional, server-sent events

{
  "translation": {
    "text": "Там, где смысл доходит без потерь.",
    "model": "glm5.3-flash",
    "prompt_tokens": 61,
    "completion_tokens": 14,
    "chunks": 1
  },
  "remaining_chars": 4999971
}

流式输出

添加 "stream": true，或发送 Accept: text/event-stream，即可接收 server-sent events：每段一个按顺序的 chunk 事件，最后是 done。

event: chunk
data: {"index":0,"total":3,"text":"Первая часть…"}

event: chunk
data: {"index":1,"total":3,"text":"Вторая часть…"}

event: done
data: {"translation":{"model":"qwen3.7-flash","chunks":3,"prompt_tokens":2410,"completion_tokens":2388},"remaining_chars":4988120}

错误

每个错误都是带有稳定错误码的 JSON。按错误码分支处理，并显示消息。

{
  "error": "Not enough characters on the balance",
  "code": "INSUFFICIENT_BALANCE",
  "details": { "required": 1834, "balance": 120 }
}

code	status
`INVALID_API_KEY`	401
`INVALID_REQUEST`	400
`INVALID_TRANSLATION`	400
`INSUFFICIENT_BALANCE`	402
`RATE_LIMITED`	429
`TRANSLATION_FAILED`	503

限制

每次请求最多 100,000 个字符，每个密钥每分钟最多 300 次请求。长文本按段落边界拆分并并行翻译。

语言

传入 en、de、zh-TW 等 ISO 代码或语言名称。使用 auto 自动检测源语言。

GET https://api.translay.app/v1/languages
Authorization: Bearer tr_live_…