> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Uppdatera innehåll i Studio-projekt POST https://api.elevenlabs.io/v1/studio/projects/{project_id}/content Content-Type: multipart/form-data Uppdaterar innehållet i Studio-projektet. Reference: https://elevenlabs.io/docs/api-reference/studio/update-content ## Servers - `https://api.elevenlabs.io` (Production, default) - `https://api.us.elevenlabs.io` (Production US) - `https://api.eu.residency.elevenlabs.io` (Production EU) - `https://api.in.residency.elevenlabs.io` (Production India) - `https://api.sg.residency.elevenlabs.io` (Production Singapore) ## Request ### Path parameters - `project_id` (string, required) — ID:t för projektet som ska användas. Du kan använda slutpunkten [List projects](/docs/api-reference/studio/get-projects) för att lista alla tillgängliga projekt. ### Body (multipart/form-data) This endpoint expects a multipart form containing an optional file. - `from_url` (string, optional) — En valfri URL från vilken vi hämtar innehåll för att initialisera Studio-projektet. Om detta anges måste 'from_url' och 'from_content' vara null. Om varken 'from_url', 'from_document' eller 'from_content' anges initialiserar vi Studio-projektet som tomt. - `from_document` (file, optional) — En valfri .epub-, .pdf-, .txt- eller liknande fil kan anges. Om den anges initialiserar vi Studio-projektet med dess innehåll. Om detta anges måste 'from_url' och 'from_content' vara null. Om varken 'from_url', 'from_document' eller 'from_content' anges initialiserar vi Studio-projektet som tomt. - `from_content_json` (string, optional) — Valfritt innehåll att initiera Studio-projektet med. Om detta anges måste 'from\_url' och 'from\_document' vara null. Om varken 'from\_url', 'from\_document' eller 'from\_content' anges initierar vi Studio-projektet tomt. Exempel: \[\{"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"}]}]}] - `auto_convert` (boolean, optional) — Om Studio-projektet ska konverteras till ljud automatiskt. ## Response ### 200 Lyckat svar - `project` (ProjectResponseModel, required) ## Errors ### 422 Unprocessable Entity Error Valideringsfel - `detail` (list of ValidationError, optional) ## Types ### ProjectResponseModel - `project_id` (string, required) — ID:t för projektet. - `name` (string, required) — Projektets namn. - `create_date_unix` (integer, required) — Projektets skapandedatum. - `created_by_user_id` (string, required, nullable) — Användar-ID:t för personen som skapade projektet. - `default_title_voice_ref_id` (string, required) — Standardreferens-ID:t för projektrösten i titlar. - `default_paragraph_voice_ref_id` (string, required) — Standardreferens-ID:t för projektrösten i stycken. - `default_model_id` (string, required) — Standardmodellens ID. - `can_be_downloaded` (boolean, required) — Om projektet kan laddas ned. - `volume_normalization` (boolean, required) — Om projektet använder volymnormalisering. - `state` (enum, required) — Projektets tillstånd. - Allowed values: `creating`, `default`, `converting`, `in_queue` - `access_level` (enum, required) — Projektets åtkomstnivå. - Allowed values: `admin`, `editor`, `commenter`, `viewer` - `quality_check_on` (boolean, required, deprecated) — Om kvalitetskontroll är aktiverad för det här projektet. - `quality_check_on_when_bulk_convert` (boolean, required, deprecated) — Om kvalitetskontroll är aktiverad för projektet vid masskonvertering. - `default_title_voice_id` (string, required, deprecated) — Standardröst-ID:t för titlar. - `default_paragraph_voice_id` (string, required, deprecated) — Standardröst-ID:t för stycken. - `last_conversion_date_unix` (integer, optional, nullable) — Datumet för den senaste konverteringen av projektet. - `title` (string, optional, nullable) — Projektets titel. - `author` (string, optional, nullable) — Projektets författare. - `description` (string, optional, nullable) — Beskrivningen av projektet. - `genres` (list of string, optional, nullable) — Lista över projektets genrer. - `cover_image_url` (string, optional, nullable) — URL:en till projektets omslagsbild. - `target_audience` (enum, optional, nullable) — Projektets målgrupp. - Allowed values: `children`, `young adult`, `adult`, `all ages` - `language` (string, optional, nullable) — Tvåställig språkkod (ISO 639-1) för projektets språk. - `content_type` (string, optional, nullable) — Projektets innehållstyp, till exempel 'Novel' eller 'Short Story' - `original_publication_date` (string, optional, nullable) — Projektets ursprungliga publiceringsdatum. - `mature_content` (boolean, optional, nullable) — Om projektet innehåller vuxeninnehåll. - `isbn_number` (string, optional, nullable) — Projektets ISBN-nummer. - `fiction` (enum, optional, nullable) — Om projektet är fiktion. - Allowed values: `fiction`, `non-fiction` - `creation_meta` (ProjectCreationMetaResponseModel, optional, nullable) — Projektets metadata för skapande. - `source_type` (enum, optional, nullable) — Projektets källtyp. - Allowed values: `blank`, `book`, `article`, `genfm`, `video`, `screenplay` - `chapters_enabled` (boolean, optional, nullable, default: true) — Om kapitel är aktiverade för projektet. - `captions_enabled` (boolean, optional, nullable, default: true) — Om bildtexter är aktiverade för projektet. - `caption_style` (CaptionStyleModel, optional, nullable) — Global formatering som ska tillämpas på alla undertexter - `caption_style_template_overrides` (map from string to CaptionStyleModel, optional, nullable) — Stiländringar som har gjorts i de angivna mallarna - `public_share_id` (string, optional, nullable) — Projektets offentliga delnings-ID. - `aspect_ratio` (enum, optional, nullable) — Projektets bildförhållande. - Allowed values: `16:9`, `9:16`, `4:5`, `1:1` - `agent_settings` (StudioAgentSettingsModel, optional, nullable) — Agentrelaterade inställningar för projektet ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### ProjectCreationMetaResponseModel - `creation_progress` (double, required) — Förloppet för att skapa projektet. - `status` (enum, required) — Statusen för åtgärden att skapa projektet. - Allowed values: `draft`, `pending`, `creating`, `finished`, `failed` - `type` (enum, required) — Typen av åtgärd för att skapa projekt. - Allowed values: `blank`, `generate_podcast`, `auto_assign_voices`, `dub_video`, `import_speech` ### CaptionStyleModel - `template` (CaptionStyleTemplateModel, optional, nullable) - `text_font` (string, optional, nullable) - `text_scale` (double, optional, nullable) - `text_color` (string, optional, nullable) - `text_align` (enum, optional, nullable) - Allowed values: `start`, `center`, `end` - `text_style` (enum, optional, nullable) - Allowed values: `normal`, `italic` - `text_weight` (enum, optional, nullable) - Allowed values: `normal`, `bold`, `900` - `text_transform` (enum, optional, nullable) - Allowed values: `none`, `uppercase` - `text_blend_mode` (enum, optional, nullable) - Allowed values: `normal`, `difference`, `multiply` - `text_shadow` (StudioTextStyleShadowModel, optional, nullable) - `text_outline` (StudioTextStyleOutlineModel, optional, nullable) - `background_enabled` (boolean, optional, nullable) - `background_color` (string, optional, nullable) - `background_opacity` (double, optional, nullable) - `background_blur` (double, optional, nullable) - `background_border_radius` (double, optional, nullable) - `word_highlights_enabled` (boolean, optional, nullable) - `word_highlights_color` (string, optional, nullable) - `word_highlights_background_color` (string, optional, nullable) - `word_highlights_opacity` (double, optional, nullable) - `word_highlights_border_radius` (double, optional, nullable) - `word_highlights_blur` (double, optional, nullable) - `section_animation` (CaptionStyleSectionAnimationModel, optional, nullable) - `word_animation` (CaptionStyleWordAnimationModel, optional, nullable) - `character_animation` (CaptionStyleCharacterAnimationModel, optional, nullable) - `cursor_enabled` (boolean, optional, nullable) - `width_pct` (double, optional, nullable) - `horizontal_placement` (CaptionStyleHorizontalPlacementModel, optional, nullable) - `vertical_placement` (CaptionStyleVerticalPlacementModel, optional, nullable) - `auto_break_enabled` (boolean, optional, nullable) - `max_lines_per_section` (integer, optional, nullable) - `max_words_per_line` (integer, optional, nullable) ### StudioAgentSettingsModel - `tool_settings` (map from string to StudioAgentToolSettingsModel, optional) ### ValidationErrorLocItems ### CaptionStyleTemplateModel - `key` (string, required) - `label` (string, required) - `requires_high_fps` (boolean, optional, default: false) ### StudioTextStyleShadowModel - `enabled` (boolean, required) - `color` (string, required) - `opacity` (double, required) - `blur` (double, required) - `offset_x` (double, required) - `offset_y` (double, required) ### StudioTextStyleOutlineModel - `enabled` (boolean, required) - `color` (string, required) - `opacity` (double, required) - `width` (double, required) ### CaptionStyleSectionAnimationModel - `enter_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` - `exit_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` ### CaptionStyleWordAnimationModel - `enter_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` - `exit_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` ### CaptionStyleCharacterAnimationModel - `enter_type` (enum, required) - Allowed values: `none`, `fade`, `typewriter` - `exit_type` (enum, required) - Allowed values: `none`, `fade` ### CaptionStyleHorizontalPlacementModel - `align` (enum, required) - Allowed values: `left`, `center`, `right` - `translate_pct` (double, required) ### CaptionStyleVerticalPlacementModel - `align` (enum, required) - Allowed values: `top`, `center`, `bottom` - `translate_pct` (double, required) ### StudioAgentToolSettingsModel - `skip_confirmation` (boolean, optional, default: false) ## Examples **Request** ```json { "from_document": ">" } ``` **Response** ```json { "project": { "project_id": "aw1NgEzBg83R7vgmiJt6", "name": "My Project", "create_date_unix": 1714204800, "created_by_user_id": "Vbtgl3bRdj6lk79rYAgx", "default_title_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb", "default_paragraph_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb", "default_model_id": "eleven_multilingual_v2", "can_be_downloaded": true, "volume_normalization": true, "state": "default", "access_level": "viewer", "quality_check_on": false, "quality_check_on_when_bulk_convert": false, "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb", "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb", "last_conversion_date_unix": 1714204800, "title": "My Project", "author": "John Doe", "description": "This is a description of my project.", "genres": [ "Novel", "Short Story" ], "cover_image_url": "https://example.com/cover.jpg", "target_audience": "young adult", "language": "en", "content_type": "Novel", "original_publication_date": "2025-01-01", "mature_content": false, "isbn_number": "978-90-274-3964-2", "fiction": "fiction", "creation_meta": { "creation_progress": 0.5, "status": "pending", "type": "blank" }, "public_share_id": "abc123def456789" } } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content" files = { "from_document": "open('', 'rb')" } payload = { "auto_convert": , "from_content_json": , "from_url": } response = requests.post(url, data=payload, files=files) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content'; const form = new FormData(); form.append('auto_convert', ''); form.append('from_content_json', ''); form.append('from_document', ''); form.append('from_url', ''); const options = {method: 'POST'}; options.body = form; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content" payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") req, _ := http.NewRequest("POST", url, payload) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content") .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content', [ 'multipart' => [ [ 'name' => 'from_document', 'filename' => '', 'contents' => null ] ] ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content"); var request = new RestRequest(Method.POST); request.AddParameter("undefined", "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let parameters = [ [ "name": "auto_convert", "value": ], [ "name": "from_content_json", "value": ], [ "name": "from_document", "fileName": "" ], [ "name": "from_url", "value": ] ] let boundary = "---011000010111000001101001" var body = "" var error: NSError? = nil for param in parameters { let paramName = param["name"]! body += "--\(boundary)\r\n" body += "Content-Disposition:form-data; name=\"\(paramName)\"" if let filename = param["fileName"] { let contentType = param["content-type"]! let fileContent = String(contentsOfFile: filename, encoding: String.Encoding.utf8) if (error != nil) { print(error as Any) } body += "; filename=\"\(filename)\"\r\n" body += "Content-Type: \(contentType)\r\n\r\n" body += fileContent } else if let paramValue = param["value"] { body += "\r\n\r\n\(paramValue)" } } let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```