POST
/api/translate
publicÜbersetzt einen Textstapel mit dem konfigurierten Projektanbieter und berücksichtigt Cache, Glossar, Bots, Kontingent und Geschwindigkeitslimit.
Auth: Projekt-API-Key über Authorization: Bearer oder den Query-Parameter ?api_key=.
Quellcode: src/app/api/translate/route.ts
Anfrage
curl https://deepglot.ai/api/translate \
-H "Authorization: Bearer dg_live_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 9b9e42d8-7ef2-4a91-82ff-b5ec71ba5832" \
-d '{
"l_from": "de",
"l_to": "en",
"words": [{ "w": "Hallo Welt", "t": 1 }],
"request_url": "https://example.com/",
"bot": 0
}'Antwort
{
"l_from": "de",
"l_to": "en",
"request_url": "https://example.com/",
"title": "",
"bot": 0,
"cache_only": false,
"from_words": ["Hallo Welt"],
"to_words": ["Hello world"]
}- Der Worttyp t folgt dem Plugin-Vertrag. Menschlicher Traffic verwendet bot=0; jeder Bot-Wert ab 1 ist ausschließlich cachebasiert und ruft keinen Anbieter auf.
- cache_only ist für Bots sowie bei deaktivierter automatischer Übersetzung true. Clients dürfen gelieferte Cache-Treffer ausgeben, aber quelltextgleiche Cache-Fehlschläge nicht als Übersetzungen speichern.
- Nur neue, beim Anbieter abgerechnete Wörter verbrauchen das Monatskontingent. 402 bedeutet Kontingentüberschreitung; 429 enthält Retry-After für Anfrage- oder Wortgeschwindigkeitslimits.
- Idempotency-Key ist optional. Erfolgreiche und deterministische Antworten können bis zu 24 Stunden ohne erneute Seiteneffekte wiedergegeben werden. Eine wiederholbare 429 wird nur während des begrenzten Retry-After-Fensters dedupliziert und wiedergegeben; danach wird derselbe Key neu ausgeführt. Ein anderer Body führt zu 409, solange der Datensatz gespeichert ist.