Introduction
Send the text to be read and, optionally, a preset voice, a short note on delivery and a language. The task returns one audio file with the script read in that voice: a 24 kHz mono MP3 unless you set output_format or sample_rate. speed, pitch and volume adjust the delivery. instructions takes plain-language direction such as tone, emotion, pace or volume and is not read aloud. SpicyAPI applies no content filter, so the script you send is the script you hear. Seed Speech 2.0 calculates the charge from each 1,000 characters of script before synthesis, so the pre-run quote is the final charge for that text.
| Field | Value |
|---|---|
| Input | Text |
| Output | Audio |
| Required field | text — 1 to 5,000 characters |
| Optional fields |
|
| Result | One audio file: MP3 (24 kHz mono) by default, or Ogg Opus |
| Billed quantity | Characters of text sent, per 1,000 |
| Typical time | About 8 seconds for 300 characters |
| Retention | Generated audio is kept for 14 days |
Request parameters
| Parameter | Required | Description |
|---|---|---|
text | Yes | Write Seed Speech 2.0’s spoken script in text, including the punctuation that should create pauses in the reading. at least 1 characters · at most 5000 characters |
voice_id | No | One of 41 preset voices. The suffix shows the languages the voice is built for. |
instructions | No | Plain-language direction on tone, emotion, pace or volume. Shapes the delivery and is not spoken. at most 1000 characters |
speed | No | Set Seed Speech 2.0’s speaking-rate multiplier from 0.5 to 2; use 1 to keep the voice’s normal pace while evaluating delivery direction for Seed Speech 2.0’s preset voices. |
pitch | No | Adjust Seed Speech 2.0’s pitch by -12 to 12 semitones, with 0 leaving the voice at its original pitch for delivery direction for Seed Speech 2.0’s preset voices. |
volume | No | Scale Seed Speech 2.0’s loudness from 0.5 to 2, keeping 1 for the normal level when comparing delivery direction for Seed Speech 2.0’s preset voices. |
language | No | Forces the reading language. Leave empty to detect it from the script. |
output_format | No | File format: mp3 (default) or opus, an Ogg Opus file that is smaller at the same quality. Does not change the price. |
sample_rate | No | Choose the output sampling rate in Hz for Seed Speech 2.0’s audio, using the rates listed for this endpoint. |
Pricing
$0.072 / 1,000 characters
Seed Speech 2.0 calculates the charge from each 1,000 characters of script before synthesis, so the pre-run quote is the final charge for that text.
Use cases
Voice-overs for short videos
Narration for explainers, product clips and social posts. The price is fixed by the script length, so you know what a batch costs before you start.
Multilingual content
Read the same script in English, Japanese, Spanish, German and more. Several voices are built to speak more than one language in the same timbre.
Uncensored audio stories
Scripts are voiced as written, however bold. In our tests the model spoke every word of the strongest monologues and narrated scenes we sent, without skipping or cutting the clip short.
Character voices
Give each character a preset voice and a one-line note on how they talk — breathless, sleepy, teasing — and keep both for the whole series.
Prompt guide & pro tips
Send the script in text
Write Seed Speech 2.0’s spoken script in text, including the punctuation that should create pauses in the reading.
Pick a voice
voice_iddefaults tostokie_en. The suffix of each voice shows the languages it is built for, for example _en or _ja_es.Describe the delivery
Put a sentence or two in instructions — for example 'slow, low and close, as if speaking to one person'. It is not read aloud.
What it returns
One audio file per task: a 24 kHz mono MP3 unless you set output_format or sample_rate. Download and archive the output of delivery direction for Seed Speech 2.0’s preset voices within 14 days; SpicyAPI deletes its stored copy after that period. The audio returned by Seed Speech 2.0 contains the performance, with no accompanying word-level timings or subtitle file.
Choosing a voice
voice_id takes one of 41 preset voices and defaults to stokie_en. The suffix of each voice name lists the languages it is built for — tim_en is English, minimi_ja Japanese, sven_de German, jess_ja_es_id_pt_en_zh speaks several. Mixed voices keep the same timbre across their languages.
Directing the delivery
instructions takes a sentence or two of plain language about how to read: tone, emotion, pace, volume. In Seed Speech 2.0, delivery instructions direct the performance while text supplies the spoken words; the direction itself is not read aloud. For exact control, speed (0.5–2), pitch (-12 to 12 semitones) and volume (0.5–2) have their own sliders.
Output format
output_format picks mp3 (default) or opus, an Ogg Opus file that is smaller at the same quality, and sample_rate goes from 8000 to 48000 Hz. None of these change the price.
Language
The language is detected from the script. language forces one of zh, en, ja, es-mx, id, pt-br, ko, it, de or fr when a short or mixed script is read in the wrong one.
Billing
Billed per 1,000 characters of text, counting spaces, punctuation and line breaks; instructions is free. Seed Speech 2.0 calculates the charge from each 1,000 characters of script before synthesis, so the pre-run quote is the final charge for that text. Failed requests are not charged.
Content
SpicyAPI adds no content filter. In our tests even the strongest scripts were voiced word for word, with nothing skipped and no clip ended early.
SpicyAPI adds no prompt or result filter to delivery direction for Seed Speech 2.0’s preset voices; this describes the platform’s treatment of Seed Speech 2.0, with your responsibility for lawful use unchanged. Secure the rights to scripts and source recordings used for delivery direction for Seed Speech 2.0’s preset voices, and identify generated speech as synthetic rather than attributing it to a real speaker.
API quick start
# 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-speech-2.0/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "stokie_en",
"output_format": "mp3"
}
}'
# 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"
See the API reference for authentication, the complete schema, polling, and error handling.
