Sprache generieren
Die erfolgreiche Antwort ist binäre Audioausgabe, kein JSON.
Auf dieser Seite
https://api.shareai.now/api/v1/audio/speechSprache generieren
- Basis-URL
https://api.shareai.now- Authentifizierung
- Bearer-API-Schlüssel oder genehmigtes OAuth-Zugriffstoken
- Erforderlicher Scope
inferenceormonetization_gateway
Die erfolgreiche Antwort ist binäre Audiodatei, nicht JSON. Speichern Sie sie mit curl --output speech.mp3 oder lesen Sie die Antwort-Bytes in Ihrem SDK. Wählen Sie eine unterstützte Modellstimme und ein Ausgabeformat; die Geschwindigkeit ist auf 0,25 bis 4 begrenzt. Das Eingabelimit beträgt 256 KiB und das synchrone Antwortlimit 2 MiB.
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/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));Anforderungsfelder#
| Feld | Typ | Bedeutung und Grenzen |
|---|---|---|
model erforderlich | Zeichenkette | Exakte aktivierte öffentliche Modellkennung. Muss diese Operation deklarieren und von Ihrer Berechtigung erlaubt sein. |
input erforderlich | Zeichenkette | Erforderlicher nicht-leerer Sprachtext, maximal 256 KiB UTF-8. Zeichentarife zählen Unicode-Zeichen, nicht kodierte Bytes. |
voice | Zeichenkette | Optionale Stimme, die vom ausgewählten Sprachmodell unterstützt wird, maximal 100 Zeichen. |
response_format | Zeichenkette | Optionale unterstützte Audio-Codierung wie mp3. Eine erfolgreiche Antwort ist binär, nicht JSON. Dauerbasierte Routen erfordern selbstbeschreibende MP3-, WAV- oder FLAC-Dateien. |
speed | Nummer | Optionale Sprachgeschwindigkeit von 0,25 bis 4; das Modell kann engere Grenzen setzen. |
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 binärer Audiodatei zurück. Die erfolgreiche Antwort ist binäre Audiodatei, nicht JSON. Speichern Sie sie mit curl --output speech.mp3 oder lesen Sie die Antwort-Bytes in Ihrem SDK. Wählen Sie eine unterstützte Modellstimme und ein Ausgabeformat; die Geschwindigkeit ist auf 0,25 bis 4 begrenzt. Das Eingabelimit beträgt 256 KiB und das synchrone Antwortlimit 2 MiB.
Abrechnungseinheiten#
Sprache kann pro Eingabezeichen, vom Provider gemeldetem Token oder generierter Sekunde abgerechnet werden, abhängig vom Modell. Zeichenzählungen verwenden Unicode-Zeichen. Dauerbasierte Abrechnung erfordert ein unterstütztes, selbstbeschreibendes MP3-, WAV- oder FLAC-Ergebnis. Ein rohes PCM-Ergebnis hat keine geschätzte Abtastrate. Token-basierte Routen benötigen eine vertrauenswürdige Nutzungsquittung.
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