Einführung
Beschreibe die gesamte Audioszene in einem Prompt: wer spricht, wie, und die Zeilen in Anführungszeichen, dazu Musik, Atmosphäre oder Soundeffekte. Die Aufgabe liefert eine Audiodatei von bis zu etwa zwei Minuten mit allem, was du beschrieben hast, einschließlich Dialogen mehrerer Sprecher: eine MP3, sofern du nicht output_format setzt. Um eine Stimme wiederzuverwenden, lade bis zu drei Referenzclips in reference_audio_urls hoch und nenne sie im Prompt @Audio1 bis @Audio3, oder gib stattdessen ein Referenzbild in image_url an; speed, pitch und volume feinjustieren die Vortragsweise. SpicyAPI wendet keinen Inhaltsfilter an: Jeder Prompt wird wie geschrieben gelesen. Jede Anfrage kostet denselben Festpreis.
| Feld | Wert |
|---|---|
| Eingabe | Text |
| Ausgabe | Audio |
| Pflichtfeld | prompt — 1 bis 2.000 Zeichen |
| Optionale Felder |
|
| Ergebnis | Eine Audiodatei von bis zu etwa zwei Minuten: standardmäßig MP3, sonst WAV, Ogg Opus, PCM |
| Sprecher | Mehrere, im Prompt beschrieben oder aus bis zu drei Referenzausschnitten übernommen; keine Stimmliste |
| Abgerechnete Menge | Ein Pauschalpreis pro Anfrage |
| Aufbewahrung | Generiertes Audio wird 14 Tage lang aufbewahrt |
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Beschreiben Sie die gesamte Szene in bis zu 2.000 Zeichen: jeden Sprecher und wie er klingt, seine genauen Zeilen in Anführungszeichen sowie Musik, Umgebungsgeräusche oder Sound… mindestens 1 Zeichen · höchstens 2000 Zeichen |
reference_audio_urls | Nein | Bis zu drei MP3- oder WAV-Ausschnitte als Vorlage: hochladen oder öffentliche URLs angeben. Jeder Ausschnitt darf höchstens 30 Sekunden lang und 10 MB groß sein. höchstens 3 Einträge |
image_url | Nein | Optionales Referenzbild, um das herum der Ton entsteht: hochladen oder eine öffentliche URL angeben und im prompt beschreiben, was die abgebildete Person sagt oder wie die Szene… mindestens 1 Zeichen |
speed | Nein | Sprechtempo von 0,5 (langsamer) bis 2 (schneller); 1 ist das normale Tempo der Stimme. Ändert den Preis nicht. |
pitch | Nein | Tonhöhenverschiebung in Halbtönen, von -12 bis 12; 0 behält die eigene Tonhöhe der Stimme bei. Ändert den Preis nicht. |
volume | Nein | Lautstärkefaktor von 0,5 bis 2; 1 ist die normale Lautstärke. Ändert den Preis nicht. |
output_format | Nein | Dateiformat: mp3 (Standard), wav, opus (Ogg Opus) oder pcm, also rohe 16-Bit-Little-Endian-Stereo-Samples, verschachtelt und ohne Header, mit der gewählten |
sample_rate | Nein | Abtastrate des Audios in Hz: 8000, 16000, 24000, 32000, 44100, 48000. Standardwert: 24000. |
Preis
$0.36 / Anfrage
Ein Pauschalpreis pro Anfrage, ein Clip von bis zu etwa zwei Minuten.
Anwendungsfälle
Hörspiele mit mehreren Figuren
Beschreiben Sie zwei oder mehr Sprecher und setzen Sie ihre Zeilen in Anführungszeichen, und das Modell gibt jedem eine eigene Stimme im selben Clip — kein eigenes Stimmmodell für jede Figur nötig.
Klanggestaltete Szenen
Ein Prompt kann Dialog, Hintergrundmusik, Umgebungsgeräusche und Soundeffekte zugleich verlangen, sodass eine einzige Anfrage eine fertige Szene liefert statt nur einer nackten Sprachzeile.
Unzensierte Audio-Fiktion
Prompts werden ohne Inhaltsfilter wie geschrieben gelesen. In unseren Tests kamen ein Ich-Monolog, erzählte Fiktion und eine Szene mit Regenatmosphäre, alle über das hinaus geschrieben, was andere Dienste akzeptieren, mit jedem gesprochenen Wort zurück.
Sprachspuren für Video
Erzeugen Sie die Szene hier und geben Sie die MP3-Datei dann an ein Talking-Avatar- oder Lip-Sync-Modell weiter, damit ein Gesicht sie vorträgt.
Prompt-Leitfaden und Praxistipps
Sprecher beschreiben
Geben Sie an, wer spricht und wie — ein atemloses Flüstern, ein warmer Erzähler — und setzen Sie die genauen Worte in Anführungszeichen.
Klanglandschaft hinzufügen
Erwähnen Sie Musik, Umgebungsgeräusche oder Soundeffekte, die neben dem Dialog laufen sollen: ein Regensturm, eine tickende Uhr, ein anschwellender Score.
Innerhalb von 2.000 Zeichen bleiben
Ein Prompt deckt eine Szene von bis zu etwa zwei Minuten ab; längere Geschichten müssen auf mehrere Anfragen verteilt werden.
Was zurückgegeben wird
Eine Audiodatei pro Aufgabe, bis zu etwa zwei Minuten lang – ein MP3, sofern Sie output_format nicht ändern. Die Datei wird in den SpicyAPI-Speicher kopiert und 14 Tage lang aufbewahrt.
Den Prompt schreiben
Seed Audio 1.0 nimmt ein einziges Feld prompt (bis zu 2.000 Zeichen) entgegen, das die gesamte Szene beschreibt:
- Wer spricht und wie — ein Flüstern, ein warmer Erzähler, eine geschriene Zeile.
- Ihre genauen Worte, in Anführungszeichen.
- Musik, Umgebungsgeräusche oder Soundeffekte, die Sie neben dem Dialog möchten.
Dieses Modell unterstützt mehr als einen Sprecher im selben Clip: Beschreiben Sie jede Figur und ihre Zeilen, und es gibt jeder eine eigene Stimme.
Referenzaudio und Referenzbild
Eine Stimmliste gibt es nicht. Um eine Stimme oder ein Geräusch wiederzuverwenden, laden Sie in reference_audio_urls bis zu drei Ausschnitte hoch und nennen sie im Prompt in der Reihenfolge des Hochladens @Audio1, @Audio2 und @Audio3 – zum Beispiel „Mit der Stimme von @Audio1 sagt ein Mann …“. Oder geben Sie in image_url ein Bild an und beschreiben Sie, was die Person darauf sagt oder wie die Szene klingt; beide Eingaben lassen sich nicht kombinieren. Verwenden Sie nur Stimmen und Bilder, für die Sie die Rechte haben.
Vortrag und Format
speed (0,5–2), pitch (-12 bis 12 Halbtöne) und volume (0,5–2) verfeinern den Vortrag. output_format wählt mp3 (Standard), wav, opus (Ogg Opus) oder pcm, und sample_rate reicht von 8000 bis 48000 Hz. pcm sind rohe 16-Bit-Little-Endian-Stereo-Samples ohne Header und lassen sich daher nicht im Browser abspielen; wählen Sie wav für dieselben Samples in einer abspielbaren Datei. Nichts davon ändert den Preis.
Abrechnung
Ein Pauschalpreis pro Anfrage, unabhängig von der Prompt-Länge. Fehlgeschlagene Anfragen werden nicht berechnet.
Inhalt
SpicyAPI fügt keinen Inhaltsfilter hinzu. In unseren Tests kamen drei Prompts, die andere Dienste ablehnen – ein Ich-Monolog, erzählte Fiktion und eine Szene mit Regenatmosphäre –, alle mit jedem gesprochenen Wort zurück.
SpicyAPI fügt keinen Inhaltsfilter hinzu: Prompts werden wie geschrieben gelesen, was auch immer sie enthalten. Du bist verantwortlich für die Szenen, die du beschreibst, und für die Verwendung des erzeugten Audios, einschließlich der Frage, es nicht als Äußerungen 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": "bytedance/seed-audio-1.0/text-to-audio",
"input": {
"output_format": "mp3",
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 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.
