curl -X POST 'https://api.elevenlabs.io/v1/studio/projects' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=string' \
  -F 'default_title_voice_id=string' \
  -F 'default_paragraph_voice_id=string' \
  -F 'default_model_id=string' \
  -F 'from_url=string' \
  -F 'from_document=@sample.bin' \
  -F 'from_content_json=string' \
  -F 'quality_preset=standard' \
  -F 'title=string' \
  -F 'author=string' \
  -F 'description=string' \
  -F 'genres=string' \
  -F 'target_audience=children' \
  -F 'language=string' \
  -F 'content_type=string' \
  -F 'original_publication_date=string' \
  -F 'mature_content=false' \
  -F 'isbn_number=string' \
  -F 'acx_volume_normalization=false' \
  -F 'volume_normalization=false' \
  -F 'pronunciation_dictionary_locators=string' \
  -F 'callback_url=string' \
  -F 'fiction=fiction' \
  -F 'apply_text_normalization=auto' \
  -F 'auto_convert=false' \
  -F 'auto_assign_voices=false' \
  -F 'source_type=blank' \
  -F 'voice_settings=string' \
  -F 'create_publishing_read=false'

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

> Create Studio 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/studio/projects' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=string'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | The name of the Studio project, used... |
| default_title_voice_id | body | string | No | The voice_id that corresponds to the... |
| default_paragraph_voice_id | body | string | No | The voice_id that corresponds to the... |

## Response (200 OK)
{"project":{"access_level":"viewer","author":"John Doe"}}

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

POST

/v1/studio/projects

ElevenLabs API

Create Studio 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
→ 208 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/studio/projects' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -F 'name=string' \  -F 'default_title_voice_id=string' \  -F 'default_paragraph_voice_id=string' \  -F 'default_model_id=string' \  -F 'from_url=string' \  -F 'from_document=@sample.bin' \  -F 'from_content_json=string' \  -F 'quality_preset=standard' \  -F 'title=string' \  -F 'author=string' \  -F 'description=string' \  -F 'genres=string' \  -F 'target_audience=children' \  -F 'language=string' \  -F 'content_type=string' \  -F 'original_publication_date=string' \  -F 'mature_content=false' \  -F 'isbn_number=string' \  -F 'acx_volume_normalization=false' \  -F 'volume_normalization=false' \  -F 'pronunciation_dictionary_locators=string' \  -F 'callback_url=string' \  -F 'fiction=fiction' \  -F 'apply_text_normalization=auto' \  -F 'auto_convert=false' \  -F 'auto_assign_voices=false' \  -F 'source_type=blank' \  -F 'voice_settings=string' \  -F 'create_publishing_read=false'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	The name of the Studio project, used for identification only.
default_title_voice_id	body	string	No	The voice_id that corresponds to the default voice used for new titles.
default_paragraph_voice_id	body	string	No	The voice_id that corresponds to the default voice used for new paragraphs.
default_model_id	body	string	No	The ID of the model to be used for this Studio project, you can query GET /v1/models to list all available models.
from_url	body	string	No	An optional URL from which we will extract content to initialize the Studio project. If this is set, 'from_url' and 'from_content' must be null. If neither 'from_url', 'from_document', 'from_content' are provided we will initialize the Studio project as blank.
from_document	body	string	No	An optional .epub, .pdf, .txt or similar file can be provided. If provided, we will initialize the Studio project with its content. If this is set, 'from_url' and 'from_content' must be null. If neither 'from_url', 'from_document', 'from_content' are provided we will initialize the Studio project as blank.
from_content_json	body	string	No	An optional content to initialize the Studio project with. If this is set, 'from_url' and 'from_document' must be null. If neither 'from_url', 'from_document', 'from_content' are provided we will initialize the Studio project as blank. Example: [{"name": "Chapter A", "blocks": [{"sub_type": "p", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "A", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "B", "type": "tts_node"}]}, {"sub_type": "h1", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "C", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "D", "type": "tts_node"}]}]}, {"name": "Chapter B", "blocks": [{"sub_type": "p", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "E", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "F", "type": "tts_node"}]}, {"sub_type": "h2", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "G", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "H", "type": "tts_node"}]}]}]
quality_preset	body	string	No	Output quality of the generated audio. Must be one of: 'standard' - standard output format, 128kbps with 44.1kHz sample rate. 'high' - high quality output format, 192kbps with 44.1kHz sample rate and major improvements on our side. 'ultra' - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side. 'ultra_lossless' - ultra quality output format, 705.6kbps with 44.1kHz sample rate and highest improvements on our side in a fully lossless format. If not provided, defaults to the highest quality preset available on your subscription tier.
title	body	string	No	An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download.
author	body	string	No	An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download.
description	body	string	No	An optional description of the Studio project.
genres	body	string[]	No	An optional list of genres associated with the Studio project.
target_audience	body	string	No	An optional target audience of the Studio project.
language	body	string	No	An optional language of the Studio project. Two-letter language code (ISO 639-1).
content_type	body	string	No	An optional content type of the Studio project.
original_publication_date	body	string	No	An optional original publication date of the Studio project, in the format YYYY-MM-DD or YYYY.
mature_content	body	boolean	No	An optional specification of whether this Studio project contains mature content.
isbn_number	body	string	No	An optional ISBN number of the Studio project you want to create, this will be added as metadata to the mp3 file on Studio project or chapter download.
acx_volume_normalization	body	boolean	No	[Deprecated] When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements
volume_normalization	body	boolean	No	When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements
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\"}"'.
callback_url	body	string	No	A url that will be called by our service when the Studio project is converted. Request will contain a json blob containing the status of the conversion Messages: 1. When project was converted successfully: { type: "project_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", conversion_status: "success", project_snapshot_id: "22m00Tcm4TlvDq8ikMAT", error_details: None, } } 2. When project conversion failed: { type: "project_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", conversion_status: "error", project_snapshot_id: None, error_details: "Error details if conversion failed" } } 3. When chapter was converted successfully: { type: "chapter_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", chapter_id: "22m00Tcm4TlvDq8ikMAT", conversion_status: "success", chapter_snapshot_id: "23m00Tcm4TlvDq8ikMAV", error_details: None, } } 4. When chapter conversion failed: { type: "chapter_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", chapter_id: "22m00Tcm4TlvDq8ikMAT", conversion_status: "error", chapter_snapshot_id: None, error_details: "Error details if conversion failed" } }
fiction	body	string	No	An optional specification of whether the content of this Studio project is fiction.
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.
auto_convert	body	boolean	No	Whether to auto convert the Studio project to audio or not.
auto_assign_voices	body	boolean	No	[Alpha Feature] Whether automatically assign voices to phrases in the create Project.
source_type	body	string	No	The type of Studio project to create.
voice_settings	body	string[]	No	Optional voice settings overrides for the project, encoded as a list of JSON strings. Example: ["{\"voice_id\": \"21m00Tcm4TlvDq8ikWAM\", \"stability\": 0.7, \"similarity_boost\": 0.8, \"style\": 0.5, \"speed\": 1.0, \"use_speaker_boost\": true}"]
create_publishing_read	body	boolean	No	If true, creates a corresponding read for direct publishing in draft state

Response 200 OK

{
  "project": {
    "access_level": "viewer",
    "author": "John Doe",
    "can_be_downloaded": true,
    "content_type": "Novel",
    "cover_image_url": "https://example.com/cover.jpg",
    "create_date_unix": 1714204800,
    "created_by_user_id": "Vbtgl3bRdj6lk79rYAgx",
    "creation_meta": {
      "creation_progress": 0.5,
      "status": "pending",
      "type": "blank"
    },
    "default_model_id": "eleven_multilingual_v2",
    "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb",
    "default_paragraph_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb",
    "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb",
    "default_title_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb",
    "description": "This is a description of my project.",
    "fiction": "fiction",
    "genres": [
      "Novel",
      "Short Story"
    ],
    "isbn_number": "978-90-274-3964-2",
    "language": "en",
    "last_conversion_date_unix": 1714204800,
    "mature_content": false,
    "name": "My Project",
    "original_publication_date": "2025-01-01",
    "project_id": "aw1NgEzBg83R7vgmiJt6",
    "public_share_id": "abc123def456789",
    "quality_check_on": false,
    "quality_check_on_when_bulk_convert": false,
    "state": "default",
    "target_audience": "young adult",
    "title": "My Project",
    "volume_normalization": true
  }
}