Einführung
Senden Sie bis zu 1.000 Zeichen englischen Text und optional, wie ausdrucksstark, wie variantenreich und wie eng geführt die Lesung sein soll. Die Aufgabe liefert eine WAV-Datei (24 kHz, 16-Bit, Mono) zurück, gelesen in der fest eingebauten Stimme von Chatterbox oder in der Stimme eines kurzen Ausschnitts, den Sie in reference_audio_url senden. Tags wie werden laut vorgelesen, schreiben Sie Laute daher stattdessen aus. SpicyAPI wendet keinen Inhaltsfilter an: ungefilterte Skripte werden wie geschrieben gelesen. Jede Anfrage kostet denselben Pauschalpreis.
| Feld | Wert |
|---|---|
| Eingabe | Text |
| Ausgabe | Audio |
| Pflichtfeld | text — 1 bis 1.000 Zeichen Englisch |
| Optionale Felder | exaggeration (0–1), temperature (0,05–2), |
| Ergebnis | Eine WAV-Datei, 24 kHz, 16-Bit, Mono |
| Stimme | Fest eingebaute Stimme oder aus |
| Abgerechnete Menge | Ein Pauschalpreis pro Anfrage |
| Aufbewahrung | Generierte Audiodateien werden 14 Tage aufbewahrt |
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
text | Ja | Bis zu 1.000 Zeichen Englisch, genau wie geschrieben vorgelesen. Tags wie werden laut vorgelesen; schreiben Sie Laute stattdessen aus. mindestens 1 Zeichen · höchstens 1000 Zeichen |
reference_audio_url | Nein | Optionaler MP3- oder WAV-Ausschnitt der Stimme, die nachgeahmt werden soll: hochladen oder eine öffentliche URL angeben. mindestens 1 Zeichen |
exaggeration | Nein | Wie emotional die Lesung klingt, von 0 (flach) bis 1 (dramatisch). Standardwert: 0,5. |
temperature | Nein | Variation zwischen Durchgängen, von 0,05 bis 2. Standardwert: 0,7. |
guidance_scale | Nein | Wie eng die Lesung dem natürlichen Tempo des Textes folgt, von 0,1 bis 1. Standardwert: 0,5; senken Sie den Wert, um eine gehetzte Lesung zu verlangsamen. |
Preis
$0.036 / Anfrage
Ein Pauschalpreis pro Anfrage für bis zu 1.000 Zeichen.
Anwendungsfälle
Spiel- und Animationszeilen
Kurze, prägnante Charakterzeilen, bei denen Energie wichtiger ist als die Wahl der Klangfarbe. Erhöhen Sie exaggeration für geschriene, lachende oder außer Atem geratene Zeilen.
Prototyp-Stimmen
Geben Sie einer Demo, einem Storyboard oder einem Chatbot eine Stimme, bevor Sie sich für eine endgültige entscheiden – zum Pauschalpreis pro Zeile.
Unzensierte Audiogeschichten
Ungefilterte Skripte werden wie geschrieben gelesen. In unseren Tests sprach das Modell jedes Wort der gesendeten Monologe und Erzähltexte und auch ausgeschriebene Laute.
Vertonung für Videos
Erzeugen Sie die Zeile hier, und geben Sie die WAV-Datei dann an ein Talking-Avatar- oder Lip-Sync-Modell weiter, damit ein Gesicht sie performt.
Prompt-Leitfaden und Praxistipps
Skript als Text senden
Bis zu 1.000 Zeichen Englisch, mit Zeichensetzung für Pausen. Lachen und Seufzer ausschreiben – Tags werden laut vorgelesen.
Die Energie einstellen
exaggeration ist standardmäßig auf 0,5 gesetzt. Erhöhen Sie den Wert für dramatische oder außer Atem geratene Zeilen, senken Sie ihn für ruhige Erzählung.
Bei Bedarf feinjustieren
Senken Sie
guidance_scale, um eine gehetzte Lesung zu verlangsamen; erhöhen Sie temperature für mehr Vielfalt zwischen Durchgängen.
Was zurückgegeben wird
Eine WAV-Datei pro Aufgabe: 24 kHz, 16-Bit, Mono-PCM. Die Datei wird in den SpicyAPI-Speicher kopiert und 14 Tage aufbewahrt. Das Ergebnis enthält keine Wort-Timings oder Untertitel.
Die Stimme
Chatterbox ist das Open-Source-Englischmodell von Resemble AI (MIT-Lizenz). Ohne Referenz liest es in seiner fest eingebauten Stimme; eine Stimmenliste gibt es nicht. Senden Sie in reference_audio_url einen kurzen MP3- oder WAV-Ausschnitt, um eine Stimme zu klonen: Die Lesung übernimmt die Klangfarbe des Ausschnitts, nicht seine Worte. Am besten funktionieren einige Sekunden einer einzelnen, klaren Stimme ohne Musik, und Sie müssen die Rechte an der Stimme haben.
Regler
exaggeration(0–1, Standardwert 0,5): wie emotional die Lesung klingt.temperature(0,05–2, Standardwert 0,7): Variation zwischen Durchgängen.guidance_scale(0,1–1, Standardwert 0,5): wie eng die Lesung dem Tempo des Textes folgt; etwa 0,3 verlangsamt einen schnellen, dramatischen Vortrag.
Tags wie <laugh>, <sigh> oder [gasp] wurden in unseren Tests als Wörter laut vorgelesen. Schreiben Sie Laute stattdessen aus: „ha…“, „mmm…“, „ahh…“.
Länge
text akzeptiert bis zu 1.000 Zeichen. Ein Absatz mit 270 Zeichen ergab in unseren Tests etwa 15 Sekunden Audio; die meisten Aufgaben waren in 10 bis 30 Sekunden fertig.
Abrechnung
Ein Pauschalpreis pro Anfrage. Fehlgeschlagene Anfragen werden nicht berechnet.
Inhalt
SpicyAPI fügt keinen Inhaltsfilter hinzu. In unseren Tests wurden ungefilterte Skripte wortgetreu gelesen, ohne etwas auszulassen und ohne dass ein Clip vorzeitig endete.
SpicyAPI fügt keinen Inhaltsfilter hinzu: Skripte werden wie geschrieben gelesen, ohne jede Abschwächung. 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": "resemble-ai/chatterbox-v1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download."
}
}'
# 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.
