Audio & Echtzeit

Übersetzung erstellen

Übersetzt Audio in englischen Text

POST
/v1/audio/translations

Übersicht

Übersetzt Audio in jeder unterstützten Sprache in englischen Text. Im Gegensatz zur Transkription gibt dieser Endpunkt unabhängig von der Eingabesprache immer englischen Text aus.

Dieser Endpunkt übersetzt Audio ins Englische. Senden Sie language nicht mit; dieser Parameter wird für Audio-Übersetzungen nicht unterstützt und kann unsupported_parameter zurückgeben. Verwenden Sie für Textübersetzungen POST /v1/translations; recommended_for=translation bezieht sich auf diese Text-API.

Request-Body

Die Übersetzung wird zurückgegeben, sobald die Verarbeitung abgeschlossen ist. Planen Sie bei längeren Audiodateien ein HTTP-Client-Timeout von mindestens 120s ein.

filefileerforderlich

Die zu übersetzende Audiodatei. Unterstützte Formate: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Die maximale Dateigröße beträgt 25 MB.

modelstringerforderlich

Derzeit deklariert kein öffentliches Modell Unterstützung für POST /v1/audio/translations; es gibt keine Standard- oder kopierbare Modell-ID.

promptstring

Ein optionaler Text, um den Stil des Modells zu steuern oder ein vorheriges Segment fortzusetzen. Sollte auf Englisch sein.

response_formatstringStandard: json

Ausgabeformat. Zulässige Werte hängen vom Modell ab; prüfen Sie dessen Details. text gibt Rohtext anstelle eines JSON-Objekts zurück.

temperaturenumber

Sampling-Temperatur zwischen 0 und 1, nur für Modelle, die diesen Parameter aufführen.

Antwort

Die folgenden Felder beschreiben JSON-Transkript- oder -Übersetzungsantworten. text, srt und vtt geben Rohtext oder Untertitel anstelle eines JSON-Objekts zurück. Zusätzliche Felder hängen vom Modell und dem Ausgabeformat ab.

textstring

Der übersetzte Text auf Englisch.

Für das Format verbose_json enthält die Antwort außerdem:

languagestring

In der Antwort angegebene Sprachbezeichnung, sofern vorhanden.

durationnumber

Die Dauer des Eingabe-Audios in Sekunden.

segmentsarray

Segmente des übersetzten Texts mit Zeitstempeln.

Anfrage

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-model-id" \
  -F "file=@german_audio.mp3"

Antwort

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

Übersetzung vs. Transkription

FeatureÜbersetzungTranskription
AusgabespracheImmer EnglischWie Eingabe
AnwendungsfallFremdsprachiges Audio ins Englische konvertierenOriginalsprache beibehalten
SprachparameterNicht zutreffendOptionaler Hinweis

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

multipart/form-data

Antwort

application/json

application/json

application/json

application/json

application/json

application/json