Entwickler · Translay

API-Schlüssel

…

Schnellstart

Erstellen Sie oben einen Schlüssel und senden Sie ihn als Bearer-Token. Zeichen werden pro Anfrage vom Guthaben abgezogen und bei Fehlschlag zurückerstattet.

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"
  }'

Anfrage

Die Antwort enthält den übersetzten Text, das verwendete Modell, den Token-Verbrauch und die Anzahl der Teile, in die der Text aufgeteilt wurde.

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
}

Streaming

Fügen Sie "stream": true hinzu oder senden Sie Accept: text/event-stream, um Server-Sent Events zu erhalten: ein chunk-Ereignis pro Teil in Reihenfolge, dann 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}

Fehler

Jeder Fehler ist JSON mit einem stabilen Code. Verzweigen Sie nach Code und zeigen Sie die Nachricht an.

{
  "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

Limits

Bis zu 100.000 Zeichen pro Anfrage und 300 Anfragen pro Minute je Schlüssel. Lange Texte werden an Absatzgrenzen geteilt und parallel übersetzt.

Sprachen

Übergeben Sie ISO-Codes wie en, de, zh-TW oder einen Sprachnamen. Verwenden Sie auto, um die Ausgangssprache zu erkennen.

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