Text & Chat

Übersetzung erstellen

Übersetzt Text in eine Zielsprache

POST
/v1/translations

Übersicht

/v1/translations wird für Text-zu-Text-Übersetzung verwendet.

Dieser Endpunkt unterscheidet sich von Audio-Übersetzung, die eine Audiodatei akzeptiert und immer englischen Text zurückgibt.

Ermitteln Sie für Agent-Workflows zuerst die aktuell empfohlenen Übersetzungsmodelle:

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

Senden Sie dann das ausgewählte Modell explizit an /v1/translations.

recommended_for=translation gilt nur für Textübersetzung (POST /v1/translations). Es gilt nicht für Audio-Übersetzung.

Anfragekörper

modelstringerforderlich

Die Übersetzungsmodell-ID, die von /v1/models?recommended_for=translation zurückgegeben wird.

textstringerforderlich

Der zu übersetzende Quelltext.

target_languagestringerforderlich

Sprachcode oder Sprachname für die Zielsprache, je nach Modellunterstützung.

source_languagestring

Optionaler Hinweis auf die Ausgangssprache.

mime_typestringStandard: text/plain

Quelltextformat. Unterstützte Werte: text/plain, text/html.

userstring

Optionale Kennung für den Endnutzer zur Missbrauchsüberwachung und Nachverfolgung.

Antwort

textstring

Übersetzter Text.

modelstring

Modell, das die Übersetzung erzeugt hat.

source_languagestring | null

Vom Modell erkannte oder akzeptierte Ausgangssprache.

target_languagestring

Für die Anfrage verwendete Zielsprache.

Anfrage

curl -X POST "https://api.tokenlab.sh/v1/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-translation",
    "text": "Hallo, willkommen bei TokenLab.",
    "target_language": "en"
  }'

Antwort

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "de",
  "target_language": "en"
}

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Header

X-TokenLab-Delivery-Policy?string

Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.

Zulässige Werte

  • "auto"
  • "verified"
  • "official"

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json

application/json

application/json