API-Referenz
Audio
Noch kein Modell verfügbar
/v1/audio/speech/v1/audio/transcriptions/v1/audio/translationsSprache in beide Richtungen: /v1/audio/speech wandelt Text in Audio-Bytes um; /v1/audio/transcriptions wandelt Audio in Text um (Whisper-kompatibel); /v1/audio/translations transkribiert direkt ins Englische.
#Anfrageparameter
modelstringerforderlichModelle der Klasse tts-1 für Sprachausgabe, der Klasse whisper-1 für Transkription.
inputstringerforderlichNur speech: der zu sprechende Text.
voicestringerforderlichNur speech: Stimmenname (alloy, nova, …); verfügbare Stimmen stehen auf der Modellkarte.
filefile (multipart)erforderlichNur transcriptions: die Audiodatei (mp3, wav, m4a, webm …).
languagestringoptionalNur transcriptions: ISO-639-1-Hinweis, der die Genauigkeit verbessert.
response_formatstringoptionalspeech: mp3 | wav | opus …; transcriptions: json | text | srt | verbose_json.
speednumberoptionalNur speech: Wiedergabegeschwindigkeit 0.25–4.0.
Zwei verschiedene Content-Types
#Zugehörige Fehler
- 413 payload_too_largeDer Anfrage-Body (Prompt, Bild- oder Audiodatei) überschreitet die zulässige Größe.
- 401Ungültiges oder fehlendes Bearer-Token. Auf diesem Pfad gibt es kein error.code — werten Sie den Status aus.
- 402 insufficient_user_quotaDas Wallet-Guthaben deckt die vorab reservierte Schätzung nicht.
- 429Drosselung pro Schlüssel. Leerer Body; warten Sie Retry-After ab. Ein 429, das insufficient_user_quota enthält, ist dagegen ein tägliches Ausgabenlimit.
- 503 model_not_foundUnbekanntes Modell, oder derzeit bedient es kein funktionsfähiger Kanal.
#Beispielanfrage
# text → speech (bytes saved to file)
curl https://www.aisplice.store/v1/audio/speech \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "tts-1", "voice": "alloy", "input": "Hello from the gateway."}' \
--output hello.mp3
# speech → text (multipart)
curl https://www.aisplice.store/v1/audio/transcriptions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-F file=@meeting.mp3 -F model=whisper-1#Antwort
// /v1/audio/speech → binary audio body (Content-Type: audio/mpeg)
// /v1/audio/transcriptions
{"text": "…transcript…"}Immer noch nicht gelöst?
Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.