Développeurs · Translay

Clés API

…

Démarrage rapide

Créez une clé ci-dessus et envoyez-la comme jeton Bearer. Les caractères sont déduits de votre solde à chaque requête et remboursés en cas d'échec.

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

Requête

La réponse contient le texte traduit, le modèle utilisé, la consommation de jetons et le nombre de parties en lesquelles le texte a été découpé.

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

Ajoutez "stream": true ou envoyez Accept: text/event-stream pour recevoir des server-sent events : un événement chunk par partie, dans l'ordre, puis 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}

Erreurs

Chaque erreur est un JSON avec un code stable. Branchez sur le code, affichez le message.

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

Limites

Jusqu'à 100 000 caractères par requête et 300 requêtes par minute et par clé. Les textes longs sont découpés aux limites de paragraphe et traduits en parallèle.

Langues

Passez des codes ISO comme en, de, zh-TW ou un nom de langue. Utilisez auto pour détecter la langue source.

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