Zum Hauptinhalt springen

Anfragekörper

Timeout für synchrone Anfragen: Dieser Nicht-Chat-Endpunkt wartet, bis das geroutete Modell fertig ist. Große Eingaben, lange Audiodateien oder große Batches können übliche 30s-Client-Defaults überschreiten; setzen Sie das Timeout Ihres HTTP-Clients daher auf mindestens 120s.
file
file
erforderlich
Audiodatei zur Transkription. Unterstützte Formate: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm.
model
string
Standard:"whisper-1"
Zu verwendendes Modell. Derzeit wird nur whisper-1 unterstützt.
language
string
Sprache des Audios im ISO-639-1-Format (z. B. en, zh, ja).
prompt
string
Optionaler Text, um den Stil des Modells zu steuern oder ein vorheriges Segment fortzusetzen.
response_format
string
Standard:"json"
Ausgabeformat: json, text, srt, verbose_json, vtt.
temperature
number
Standard:"0"
Sampling-Temperatur (0 bis 1).
timestamp_granularities
array
Granularität der Zeitstempel: word und/oder segment. Erfordert verbose_json.

Antwort

text
string
Der transkribierte Text.
Für verbose_json:
task
string
Immer transcribe.
language
string
Erkannte Sprache.
duration
number
Audiodauer in Sekunden.
segments
array
Transkriptionssegmente mit Zeitstempeln.
words
array
Zeitstempel auf Wortebene (falls angefordert).
curl -X POST "https://api.tokenlab.sh/v1/audio/transcriptions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F file="@audio.mp3" \
  -F model="whisper-1" \
  -F language="en"
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh/v1"
)

with open("audio.mp3", "rb") as audio_file:
    response = client.audio.transcriptions.create(
        model="whisper-1",
        file=audio_file,
        language="en"
    )

print(response.text)
import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.tokenlab.sh/v1'
});

const response = await client.audio.transcriptions.create({
  model: 'whisper-1',
  file: fs.createReadStream('audio.mp3'),
  language: 'en'
});

console.log(response.text);
<?php
$ch = curl_init('https://api.tokenlab.sh/v1/audio/transcriptions');

$file = new CURLFile('audio.mp3', 'audio/mpeg', 'audio.mp3');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-your-api-key'
    ],
    CURLOPT_POSTFIELDS => [
        'file' => $file,
        'model' => 'whisper-1',
        'language' => 'en'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['text'];
{
  "text": "Hello, this is a test of the transcription API."
}
{
  "task": "transcribe",
  "language": "english",
  "duration": 5.5,
  "text": "Hello, this is a test of the transcription API.",
  "segments": [
    {
      "id": 0,
      "start": 0.0,
      "end": 2.5,
      "text": "Hello, this is a test",
      "tokens": [...]
    }
  ]
}

Übersetzung

Um Audio ins Englische zu übersetzen, verwenden Sie den translations-Endpunkt:
response = client.audio.translations.create(
    model="whisper-1",
    file=audio_file
)