Audio generieren
Der ShareAI-Endpunkt liefert ein begrenztes JSON-Audioergebnis zurück.
Auf dieser Seite
https://api.shareai.now/api/v1/audio/generationsAudio generieren
- Basis-URL
https://api.shareai.now- Authentifizierung
- Bearer-API-Schlüssel oder genehmigtes OAuth-Zugriffstoken
- Erforderlicher Scope
inferenceormonetization_gateway
Der ShareAI-Endpunkt liefert ein begrenztes JSON-Audioergebnis. Audio-generierende Anfragen mit modalities:["text","audio"] können auch verwenden /api/v1/chat/completions. Ihre Anfrage wird an die deklarierte Audiooperation weitergeleitet. Diese synchrone Antwort wird vor der Rückgabe gesammelt; unvollständige Provider-Streams werden nicht als erfolgreich abgerechnete Ergebnisse gewertet. Audioausgabeformate sind mp3, wav, flac, pcm16 oder pcm24, abhängig vom Modell. Rohes PCM unterstützt keine Dauergebühr. Legen Sie entweder max_tokens oder max_completion_tokens fest, um generierte Tokens zu begrenzen; geben Sie nicht beide an.
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/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', 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/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Anforderungsfelder#
| Feld | Typ | Bedeutung und Grenzen |
|---|---|---|
model erforderlich | Zeichenkette | Exakte aktivierte öffentliche Modellkennung. Muss diese Operation deklarieren und von Ihrer Berechtigung erlaubt sein. |
messages erforderlich | Array | 1–256 Konversationsnachrichten mit Rolle/Inhalt. Verwenden Sie nur Inhaltsmodalitäten, die vom ausgewählten Audiomodell unterstützt werden. |
modalities | Array | Ein oder zwei eindeutige Werte aus Text und Audio; Audio ist erforderlich. Standardmäßig auf Audio. Dieser synchrone Endpunkt akzeptiert keinen Stream. |
audio | Objekt | Optionale Ausgabeoptionen: nur Stimme und Format. format ist mp3, wav, flac, pcm16 oder pcm24, abhängig von der Modellunterstützung. Rohes PCM ist mit Dauergebühren nicht kompatibel. |
temperature | Nummer | Optionale, vom Modell unterstützte Generierungstemperatur. |
top_p | Nummer | Optionale, vom Modell unterstützte Nucleus-Sampling-Wert. |
max_tokens | Ganzzahl | Optionale Begrenzung der Ausgabetokens, 1–262144. Nicht mit max_completion_tokens kombinieren. |
max_completion_tokens | Ganzzahl | Optionale Begrenzung der Ausgabetokens, 1–262144. Nicht mit max_tokens kombinieren. |
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. Der ShareAI-Endpunkt liefert ein begrenztes JSON-Audioergebnis. Audio-generierende Anfragen mit modalities:["text","audio"] können auch verwenden /api/v1/chat/completions. Ihre Anfrage wird an die deklarierte Audiooperation weitergeleitet. Diese synchrone Antwort wird vor der Rückgabe gesammelt; unvollständige Provider-Streams werden nicht als erfolgreich abgerechnete Ergebnisse gewertet. Audioausgabeformate sind mp3, wav, flac, pcm16 oder pcm24, abhängig vom Modell. Rohes PCM unterstützt keine Dauergebühr. Legen Sie entweder max_tokens oder max_completion_tokens fest, um generierte Tokens zu begrenzen; geben Sie nicht beide an.
Abrechnungseinheiten#
Audiomodelle können separate Text-Token- und Audio-Token-Dimensionen, Dauer, Song- oder Anfrageraten veröffentlichen. Inklusive Token-Gesamtsummen werden in getrennte Text-/Audiozähler aufgeteilt; dieselben Audiotokens werden niemals erneut als Text berechnet. Nicht unterstützte oder fehlende Nutzung wird nicht aus kodierten Bytes approximiert.
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