Bytedance Seed Audio 1.0 API Documentation

Playground

ByteDance Seed Audio 1.0 Text to Audio generates natural speech and audio from text prompts, with optional preset voice, reference audio, or reference image guidance for flexible audio creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

ByteDance Seed Audio generates natural speech and audio from a text prompt. It supports preset voices, optional reference audio clips, optional image guidance, and common audio output controls such as format, sample rate, speed, volume, and pitch.

Why Choose This?

Natural speech and audio generation
Generate speech or audio directly from a text prompt.
Preset voice support
Choose from multiple preset voices for text-to-speech generation.
Reference audio guidance
Upload up to 3 reference audio clips to guide the generated voice or audio style.
Image guidance support
Provide a single reference image to guide audio generation.
Flexible audio controls
Adjust output format, sample rate, speed, volume, and pitch to match your workflow.

Parameters

Parameter	Required	Description
prompt	Yes	Text or audio prompt to synthesize.
audios	No	Optional reference audio URLs. Upload up to 3 clips. Do not use together with `image`.
image	No	Optional single reference image URL. Do not use together with `audio`.
output_format	No	Audio output format: `wav`, `mp3`, `pcm`, or `ogg_opus`. Default: `mp3`.
sample_rate	No	Output sample rate in Hz. Supported values: `8000`, `16000`, `24000`, `32000`, `44100`, `48000`. Default: `24000`.
speed	No	Speech speed multiplier. Range: `0.5` to `2`. Default: `1`.
volume	No	Speech volume multiplier. Range: `0.5` to `2`. Default: `1`.
pitch	No	Pitch shift in semitones. Range: `-12` to `12`. Default: `0`.

How to Use

Write your prompt — Enter the text or audio description you want to synthesize.
Add reference audio optional — Upload up to 3 audio clips when you want reference-based voice or audio guidance.
Add image guidance optional — Use image when you want to guide generation from a single reference image.
Set audio controls optional — Choose output format, sample rate, speed, volume, and pitch.
Submit — Generate the final audio output.

Pricing

Just $0.3 per generate.

Best Use Cases

Text-to-speech generation — Convert written text into natural spoken audio.
Voice-guided speech generation — Use reference audio clips to guide the generated voice or audio style.
Image-guided audio generation — Use a reference image to guide audio creation.
Narration and dialogue — Generate voice audio for videos, demos, apps, and creative projects.
Audio prototyping — Test different voices, speeds, volumes, pitches, and output formats.

Pro Tips

Use a clear and focused prompt for more stable audio generation.
Use clean reference audio clips when voice or style guidance matters.
Use mp3 for general-purpose output and smaller file size.
Use wav when you need higher-quality audio for post-production.
Adjust speed, volume, and pitch only when you need specific delivery control.
Ensure reference audio and image URLs are publicly accessible.


## Authentication

For authentication details, please refer to the [Authentication Guide](/api-authentication).

## API Endpoints

### Submit Task & Query Result

<ApiTabs submitUrl={model.submitUrl} resultUrl={model.resultUrl} payload={model.defaultValues} />

## Parameters

### Task Submission Parameters

#### Request Parameters

<RequestParams params={model.params} conditions={model.conditions} />

Every model also accepts the global request options [`enable_sync_mode`](/sync-mode) and [`enable_base64_output`](/base64-output); see their pages for details.

#### Response Parameters

<SubmitResponse />

#### Result Request Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| id | string | Yes | - | Task ID |

#### Result Response Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., "success") |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction |
| data.model | string | Model ID used for the prediction |
| data.outputs | array&lt;string \| object&gt; | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.status | string | Status: `completed` is successful; `failed`, `cancelled`, `timeout`, and `deleted` are failure terminal statuses |
| data.created_at | string | ISO timestamp of when the request was created |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |

Overview