aisplice

API-Referenz

Audio

Noch kein Modell verfügbar

Derzeit unterstützt kein Modell im Modellkatalog diese Route. Die Seite bleibt als Referenz erhalten.
POST/v1/audio/speech
POST/v1/audio/transcriptions
POST/v1/audio/translations

Sprache 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

  • modelstringerforderlich

    Modelle der Klasse tts-1 für Sprachausgabe, der Klasse whisper-1 für Transkription.

  • inputstringerforderlich

    Nur speech: der zu sprechende Text.

  • voicestringerforderlich

    Nur speech: Stimmenname (alloy, nova, …); verfügbare Stimmen stehen auf der Modellkarte.

  • filefile (multipart)erforderlich

    Nur transcriptions: die Audiodatei (mp3, wav, m4a, webm …).

  • languagestringoptional

    Nur transcriptions: ISO-639-1-Hinweis, der die Genauigkeit verbessert.

  • response_formatstringoptional

    speech: mp3 | wav | opus …; transcriptions: json | text | srt | verbose_json.

  • speednumberoptional

    Nur speech: Wiedergabegeschwindigkeit 0.25–4.0.

Zwei verschiedene Content-Types

speech erwartet einen JSON-Body und liefert rohe Audio-Bytes; transcriptions/translations erwarten multipart/form-data und liefern JSON. Vermischen Sie die beiden nicht.

#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.

Vollständige Fehlercode-Tabelle →

#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

response.json
// /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.