Text & Chat
Übersetzung erstellen
Übersetzt Text in eine Zielsprache
Ü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
Übersetzungsmodell-ID, die von /v1/models?recommended_for=translation zurückgegeben wird.
Zu übersetzender Quelltext. Die Begrenzung der Eingabelänge hängt vom Modell ab; lesen Sie max_input_tokens in GET /v1/models/{model} nach.
Zielsprachencode oder Sprachname, abhängig von der Modellunterstützung.
Optionaler Hinweis auf die Quellsprache.
text/plainFormat des Quelltexts: text/plain oder text/html. Senden Sie diesen Parameter nur, wenn die Modelldetails mime_type auflisten.
Optionaler Endbenutzer-Identifikator für die Missbrauchsüberwachung und Request-Rückverfolgung. Senden Sie diesen Parameter nur, wenn die Modelldetails user auflisten.
Antwort
Übersetzter Text.
Modell, das die Übersetzung generiert hat.
Quellsprache, die vom Modell erkannt oder akzeptiert wurde.
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
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}Fehler
| Status | Code | Ursache |
|---|---|---|
400 | invalid_request | model, text oder target_language fehlt oder ist leer, oder mime_type entspricht keinem der beiden Werte. param benennt das Feld |
400 | unsupported_endpoint | Das Modell ist für diesen Endpunkt nicht veröffentlicht |
Behandeln Sie andere Statuscodes wie in API-Fehler behandeln beschrieben.
Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
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