curl -X POST 'https://api.elevenlabs.io/v1/audio-native' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=string' \
  -F 'image=string' \
  -F 'author=string' \
  -F 'title=string' \
  -F 'small=false' \
  -F 'text_color=string' \
  -F 'background_color=string' \
  -F 'sessionization=0' \
  -F 'voice_id=string' \
  -F 'model_id=string' \
  -F 'file=@sample.bin' \
  -F 'auto_convert=false' \
  -F 'apply_text_normalization=auto' \
  -F 'pronunciation_dictionary_locators=string'

# POST /v1/audio-native (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Creates Audio Native Enabled Project.

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/audio-native' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=string'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | Project name. |
| image | body | string | No | (Deprecated) Image URL used in the pl... |
| author | body | string | No | Author used in the player and inserte... |

## Response (200 OK)
{"converting":false,"html_snippet":"<div id='audio-native-player'></div>"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

/v1/audio-native

ElevenLabs API

Creates Audio Native Enabled Project.

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 207 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/audio-native' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -F 'name=string' \  -F 'image=string' \  -F 'author=string' \  -F 'title=string' \  -F 'small=false' \  -F 'text_color=string' \  -F 'background_color=string' \  -F 'sessionization=0' \  -F 'voice_id=string' \  -F 'model_id=string' \  -F 'file=@sample.bin' \  -F 'auto_convert=false' \  -F 'apply_text_normalization=auto' \  -F 'pronunciation_dictionary_locators=string'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	Project name.
image	body	string	No	(Deprecated) Image URL used in the player. If not provided, default image set in the Player settings is used.
author	body	string	No	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.
title	body	string	No	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.
small	body	boolean	No	(Deprecated) Whether to use small player or not. If not provided, default value set in the Player settings is used.
text_color	body	string	No	Text color used in the player. If not provided, default text color set in the Player settings is used.
background_color	body	string	No	Background color used in the player. If not provided, default background color set in the Player settings is used.
sessionization	body	integer	No	(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_id	body	string	No	Voice ID used to voice the content. If not provided, default voice ID set in the Player settings is used.
model_id	body	string	No	TTS Model ID used in the player. If not provided, default model ID set in the Player settings is used.
file	body	string	No	Either txt or HTML input file containing the article content. HTML should be formatted as follows '<html><body><div><p>Your content</p><h3>More of your content</h3><p>Some more of your content</p></div></body></html>'
auto_convert	body	boolean	No	Whether to auto convert the project to audio or not.
apply_text_normalization	body	string	No	This parameter controls text normalization with four modes: 'auto', 'on', 'apply_english' and 'off'. When set to 'auto', the system will automatically decide whether to apply text normalization (e.g., spelling out numbers). With 'on', text normalization will always be applied, while with 'off', it will be skipped. 'apply_english' is the same as 'on' but will assume that text is in English.
pronunciation_dictionary_locators	body	string[]	No	A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"Vmd4Zor6fplcA7WrINey\",\"version_id\":\"hRPaxjlTdR7wFMhV4w0b\"}"' --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"JzWtcGQMJ6bnlWwyMo7e\",\"version_id\":\"lbmwxiLu4q6txYxgdZqn\"}"'.

Response 200 OK

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