Einführung
Senden Sie den vorzulesenden Text und optional eine von neun Stimmen, eine kurze Notiz zum Vortrag und eine Sprache. Die Aufgabe liefert eine MP3-Datei (24 kHz, Mono) mit dem in dieser Stimme gelesenen Skript zurück. instructions nimmt Regieanweisungen in einfacher Sprache entgegen, etwa Tonfall, Emotion oder Tempo, und wird nicht mitgesprochen. SpicyAPI wendet keinen Inhaltsfilter an: NSFW-Skripte werden genau wie geschrieben vorgelesen. Abgerechnet wird pro 1.000 Zeichen des gesendeten Textes, mit einem Minimum von 100 Zeichen.
| Feld | Wert |
|---|---|
| Eingabe | Text |
| Ausgabe | Audio |
| Pflichtfeld | text — 1 bis 2.000 Zeichen |
| Optionale Felder |
|
| Ergebnis | Eine MP3-Datei, 24 kHz, Mono |
| Abgerechnete Menge | Gesendete Zeichen von text, pro 1.000; Minimum 100 |
| Typische Dauer | Etwa 30 Sekunden für 300 Zeichen |
| Aufbewahrung | Generierte Audiodateien werden 14 Tage aufbewahrt |
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
text | Ja | Die zu sprechenden Worte, genau wie geschrieben. Abgerechnet pro 1.000 Zeichen, mindestens 100 pro Anfrage. mindestens 1 Zeichen · höchstens 2000 Zeichen |
voice_id | Nein | Eine von neun vorgefertigten Stimmen. Standardwert: Serena. |
instructions | Nein | Regieanweisung in einfacher Sprache zu Tonfall, Emotion oder Tempo. Prägt den Vortrag und wird nicht mitgesprochen. höchstens 1000 Zeichen |
language | Nein | Sprache des Vortrags. auto erkennt sie aus dem Skript. |
Preis
$0.068 / 1.000 Zeichen
Abgerechnet pro 1.000 gesendete Zeichen des Textes, einschließlich Leerzeichen und Satzzeichen, mit einem Minimum von 100 Zeichen pro Anfrage. Der Kostenvoranschlag vor dem Lauf ist der Endpreis.
Anwendungsfälle
Figuren- und Begleiterstimmen
Neun unterschiedliche Stimmen – von hell und schrill bis tief und sanft – jeweils mit einer kurzen Notiz dazu, wie sie sprechen, und über eine ganze Serie hinweg beibehalten.
Chinesische, japanische und koreanische Zeilen
Dylan und Eric sprechen Peking- und Sichuan-Dialekt, und Ono_Anna und Sohee sind waschechte japanische und koreanische Sprecherinnen, sodass Zeilen in diesen Sprachen natürlich statt akzentbehaftet klingen.
Unzensierte Audiogeschichten
NSFW-Skripte werden genau wie geschrieben vorgelesen. In unseren Tests sprach das Modell jedes Wort der Monologe und Erzählpassagen, die wir schickten, ohne etwas zu überspringen oder den Clip vorzeitig abzuschneiden.
Sprachspuren für Videos
Erzeugen Sie die Zeile hier und übergeben Sie die MP3-Datei dann an ein Talking-Avatar- oder Lip-Sync-Modell, damit ein Gesicht sie performt.
Prompt-Leitfaden und Praxistipps
Skript in text senden
Schreiben Sie es genau so, wie es gesprochen werden soll, mit Satzzeichen für Pausen. Bis zu 2.000 Zeichen; kürzere Texte als 100 Zeichen werden als 100 abgerechnet.
Stimme wählen
voice_idist standardmäßig auf Serena gesetzt, eine warme, sanfte weibliche Stimme. Ryan und Aiden sind englische männliche Stimmen; Ono_Anna und Sohee sind japanisch und koreanisch; Dylan und Eric sprechen Peking- und Sichuan-Dialekt.Vortrag beschreiben
Schreiben Sie ein bis zwei Sätze in instructions – zum Beispiel „atemlos und neckisch, nah am Mikrofon“. Der Text wird nicht mitgesprochen.
Was zurückgegeben wird
Eine MP3-Datei pro Aufgabe, 24 kHz, Mono. Die Datei wird in den SpicyAPI-Speicher kopiert und 14 Tage aufbewahrt. Das Ergebnis enthält keine Wort-Timings oder Untertitel.
Eine Stimme wählen
voice_id akzeptiert eine von neun vorgefertigten Stimmen und ist standardmäßig auf Serena gesetzt:
Serena— warme, sanfte junge weibliche StimmeVivian— helle, leicht schrille junge weibliche StimmeUncle_Fu— erfahrener Mann mit tiefem, sanftem TimbreRyan— dynamischer Mann mit starkem rhythmischem DriveAiden— sonniger amerikanischer MannOno_Anna— verspielte japanische StimmeSohee— warme, gefühlvolle koreanische StimmeDylan— jugendlicher Mann mit Peking-DialektEric— lebhafter Mann mit Sichuan-Dialekt (Chengdu)
Den Vortrag steuern
instructions nimmt ein bis zwei Sätze in einfacher Sprache dazu entgegen, wie vorgelesen werden soll: Tonfall, Emotion, Tempo. Es prägt die Performance und wird nicht mitgesprochen. Regler für Geschwindigkeit und Tonhöhe sind nicht verfügbar; fordern Sie diese stattdessen in instructions an.
Sprache
language ist standardmäßig auf auto gesetzt, wodurch die Sprache aus dem Skript erkannt wird. Setzen Sie zh, en, de, fr, es, it, pt, ru, ja oder ko, wenn ein kurzes oder gemischtsprachiges Skript in der falschen Sprache vorgelesen wird.
Abrechnung
Abgerechnet pro 1.000 Zeichen von text, einschließlich Leerzeichen, Satzzeichen und Zeilenumbrüchen, mit einem Minimum von 100 Zeichen pro Anfrage; instructions ist kostenlos. Die Zeichenzahl steht schon vor dem Start der Aufgabe fest, sodass der Kostenvoranschlag die endgültige Abrechnung ist. Fehlgeschlagene Anfragen werden nicht berechnet.
Inhalt
SpicyAPI fügt keinen Inhaltsfilter hinzu. In unseren Tests wurden ungefilterte Skripte Wort für Wort gelesen, ohne etwas auszulassen und ohne dass ein Clip vorzeitig endete.
SpicyAPI fügt keinen Inhaltsfilter hinzu: NSFW-Skripte werden genau wie geschrieben vorgelesen. Sie sind verantwortlich für die Skripte, die Sie senden, und dafür, wie Sie die resultierende Audiodatei verwenden – auch dafür, sie nicht als die Worte einer realen Person auszugeben.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-3-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"language": "auto",
"voice_id": "Serena"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.





