Audio transkribieren
Geben Sie Base64-Audio in input_audio.data und dessen tatsächliches Format an.
Auf dieser Seite
https://api.shareai.now/api/v1/audio/transcriptionsAudio transkribieren
- Basis-URL
https://api.shareai.now- Authentifizierung
- Bearer-API-Schlüssel oder genehmigtes OAuth-Zugriffstoken
- Erforderlicher Scope
inferenceormonetization_gateway
Geben Sie Base64-Audio ein input_audio.data und dessen tatsächliche format. Unterstützte Sprachen, Eingabeaufforderungen, Antwortformate und Zeitstempeloptionen hängen vom Modell ab. Dieser JSON-Endpunkt akzeptiert keine Multipart-Datei-Uploads. Die Antwort enthält die Transkription und die gemeldete Nutzung.
Bevor Sie beginnen#
Setzen Sie SHAREAI_API_KEY auf Ihrem Server und ersetzen Sie den Modell-Platzhalter durch ein derzeit aktiviertes Modell. Geben Sie den API-Schlüssel niemals im Browsercode preis. Das Modell, das Konto, die Berechtigung und der Anbieter müssen diese Operation erlauben. Die unten aufgeführten optionalen Einstellungen erfordern Modellunterstützung; die Sicherheitsgrenzen der API garantieren nicht, dass jedes Modell jeden Wert unterstützt.
Eine Anfrage senden#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/transcriptions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_TRANSCRIPTION_MODEL',
'input_audio': {'data': 'UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
'format': 'wav'}}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/transcriptions', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/transcriptions", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Das Beispiel enthält eine kleine stille WAV-Datei, die ausschließlich den gültigen Base64-Transport demonstriert. Ersetzen Sie input_audio.data durch das Standard-Base64 Ihrer eigenen Audiodatei; verwenden Sie für Python base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”). Fügen Sie keine Audio-URL in dieses Feld ein.
Anforderungsfelder#
| Feld | Typ | Bedeutung und Grenzen |
|---|---|---|
model erforderlich | Zeichenkette | Exakte aktivierte öffentliche Modellkennung. Muss diese Operation deklarieren und von Ihrer Berechtigung erlaubt sein. |
input_audio erforderlich | Objekt | Erforderliche Daten- und Formatfelder. data ist das Standard-Base64 der tatsächlichen Audio-Bytes; format muss übereinstimmen. Nur JSON; Multipart wird nicht unterstützt. Dauergebühren erfordern WAV, MP3 oder FLAC mit einer bekannten Zeitbasis, maximal 600 Sekunden kombiniert. |
language | Zeichenkette | Optionaler modellunterstützter Sprachcode. |
prompt | Zeichenkette | Optionaler modellunterstützter Transkriptionskontext; keine Audio-Generierungsaufforderung. |
response_format | Zeichenkette | Modellunterstütztes Antwortformat, maximal 100 Zeichen. Der Vorgang bestimmt, ob das Ergebnis JSON oder binär ist. |
timestamp_granularities | Array | Optionale modellunterstützte Werte für die Zeitstempelgranularität. Die Verfügbarkeit hängt vom Antwortformat und Modell ab. |
provider | Objekt | Optionale Routing-Präferenzen für Anbieter. Verwenden Sie provider.only für akzeptierte Anbieter-Tags, nicht als Präfix in der Modell-ID. Konto- und Berechtigungsbeschränkungen gelten weiterhin. |
Das Ergebnis lesen#
Erfolg gibt HTTP 200 mit JSON zurück. Geben Sie Base64-Audio ein input_audio.data und dessen tatsächliche format. Unterstützte Sprachen, Eingabeaufforderungen, Antwortformate und Zeitstempeloptionen hängen vom Modell ab. Dieser JSON-Endpunkt akzeptiert keine Multipart-Datei-Uploads. Die Antwort enthält die Transkription und die gemeldete Nutzung.
Abrechnungseinheiten#
Die Transkription verwendet die veröffentlichte Dauer- und/oder Token-Gebühr des Modells. Vom Provider gemeldete Sekunden und Tokens bleiben separate Messgrößen. Die Base64-Länge ist keine Audiodauer oder Tokenanzahl. Dauergebühren für Eingaben erfordern selbsterklärende WAV-, MP3- oder FLAC-Dateien mit einer kombinierten Dauer von maximal 600 Sekunden; unbekannte oder rohe PCM-Zeitbasen werden für die Dauerpreisgestaltung nicht zugelassen.
Wählen Sie die exakte aktivierte Modellkennung aus der Konsole. Die deklarierte Operation und die Eingabe-/Ausgabefunktionen müssen mit diesem Endpunkt übereinstimmen; ein Text-Chat-Modell kann nicht für eine andere Operation ersetzt werden. Ihre Berechtigungen, Anbieter- und Kontobeschränkungen gelten weiterhin.
Preise und Nutzung#
Die Tarife werden in EUR AI-Credits für das ausgewählte Modell, den Anbieter, die Einheiten und Varianten veröffentlicht. Es werden nur die Dimensionen im aktiven Tarif berechnet. Eine Schätzung reserviert Credits vor der Ausführung; die endgültigen Kosten basieren auf gemessener Nutzung. Preise können von der Auflösung, dem Ausgabeformat oder einem Nutzungsband abhängen. Überprüfen Sie die Konsolennutzung für die endgültige ShareAI-Belastung. Upstream-Kostenfelder und Medienbytes werden nicht in erfundene Token-Mengen umgerechnet.
Zugriff und Fehler#
Verwenden Sie inference für genehmigte netzwerkkostenbasierte Inferenz oder monetization_gateway für einen genehmigten Builder-Aufschlag und akzeptierte Abrechnungsbedingungen. Zugriff nur mit Identitätsnachweis autorisiert keine Ausgaben. Validierung, Modellautorisierung, unzureichende Credits, Ratenlimits und Ausführungsfehler geben eine strukturierte error. Nach einem Timeout oder einer unsicheren Übermittlung überprüfen Sie die Nutzung oder den Videoauftrag, bevor Sie eine weitere potenziell kostenpflichtige Anfrage erstellen.
Zuletzt aktualisiert am 3. November 2026