Create audio native project — ElevenLabs Documentation

Creates Audio Native enabled project, optionally starts conversion and returns project ID and embeddable HTML snippet.

Request

This endpoint expects a multipart form containing an optional file.

namestringRequired

Project name.

imagestringOptional

(Deprecated) Image URL used in the player. If not provided, default image set in the Player settings is used.

authorstringOptional

Author used in the player and inserted at the start of the uploaded article. If not provided, the default author set in the Player settings is used.

titlestringOptional

Title used in the player and inserted at the top of the uploaded article. If not provided, the default title set in the Player settings is used.

smallbooleanOptionalDefaults to false

(Deprecated) Whether to use small player or not. If not provided, default value set in the Player settings is used.

text_colorstringOptional

Text color used in the player. If not provided, default text color set in the Player settings is used.

background_colorstringOptional

Background color used in the player. If not provided, default background color set in the Player settings is used.

sessionizationintegerOptionalDefaults to 0

(Deprecated) Specifies for how many minutes to persist the session across page reloads. If not provided, default sessionization set in the Player settings is used.

voice_idstringOptional

Voice ID used to voice the content. If not provided, default voice ID set in the Player settings is used.

model_idstringOptional

TTS Model ID used in the player. If not provided, default model ID set in the Player settings is used.

filefileOptional

Either txt or HTML input file containing the article content. HTML should be formatted as follows ‘<html><body><div><p>Your content</p><h5>More of your content</h5><p>Some more of your content</p></div></body></html>’

auto_convertbooleanOptionalDefaults to false

Whether to auto convert the project to audio or not.

Response

Successful Response

project_idstring

The ID of the created Audio Native project.

convertingboolean

Whether the project is currently being converted.

html_snippetstring

The HTML snippet to embed the Audio Native player.

1	curl -X POST https://api.elevenlabs.io/v1/audio-native \
2	-H "xi-api-key: <apiKey>" \
3	-H "Content-Type: multipart/form-data" \
4	-F name="name" \
5	-F file=@<file1>

1	{
2	"project_id": "JBFqnCBsd6RMkjVDRZzb",
3	"converting": false,
4	"html_snippet": "<div id='audio-native-player'></div>"
5	}

Request

Response

Errors