Text & Chat

Übersetzung erstellen

Übersetzt Text in eine Zielsprache

POST
/v1/translations

Übersicht

Verwenden Sie /v1/translations für die Text-zu-Text-Übersetzung.

Dieser Endpunkt unterscheidet sich von der Audio-Übersetzung, die eine Audiodatei entgegennimmt und immer englischen Text ausgibt.

Verwenden Sie die Models-API, um aktuelle Textübersetzungsmodelle abzurufen:

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

Senden Sie anschließend das ausgewählte Modell explizit an /v1/translations.

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

Request-Body

modelstringerforderlich

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

textstringerforderlich

Zu übersetzender Quelltext. Die Begrenzung der Eingabelänge hängt vom Modell ab; lesen Sie max_input_tokens in GET /v1/models/{model} nach.

target_languagestringerforderlich

Zielsprachencode oder Sprachname, abhängig von der Modellunterstützung.

source_languagestring

Optionaler Hinweis auf die Quellsprache.

mime_typestringStandard: text/plain

Format des Quelltexts: text/plain oder text/html. Senden Sie diesen Parameter nur, wenn die Modelldetails mime_type auflisten.

userstring

Optionaler Endbenutzer-Identifikator für die Missbrauchsüberwachung und Request-Rückverfolgung. Senden Sie diesen Parameter nur, wenn die Modelldetails user auflisten.

Antwort

textstring

Übersetzter Text.

modelstring

Modell, das die Übersetzung generiert hat.

source_languagestring | null

Quellsprache, die vom Modell erkannt oder akzeptiert wurde.

target_languagestring

Für den Request 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": "你好,欢迎使用 TokenLab。",
    "target_language": "en"
  }'

Antwort

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

Fehler

StatusCodeUrsache
400invalid_requestmodel, text oder target_language fehlt oder ist leer, oder mime_type entspricht keinem der beiden Werte. param benennt das Feld
400unsupported_endpointDas Modell ist für diesen Endpunkt nicht veröffentlicht

Behandeln Sie andere Statuscodes wie in API-Fehler behandeln beschrieben.

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