> 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. # Audio-Native-Projekt erstellen POST https://api.elevenlabs.io/v1/audio-native Content-Type: multipart/form-data Erstellt ein Audio-Native-fähiges Projekt, startet optional die Konvertierung und gibt die Projekt-ID sowie ein einbettbares HTML-Snippet zurück. Reference: https://elevenlabs.io/docs/api-reference/audio-native/create ## 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 ### Body (multipart/form-data) This endpoint expects a multipart form containing an optional file. - `name` (string, required) — Projektname. - `image` (string, optional) — (Veraltet) Im Player verwendete Bild-URL. Wenn sie nicht angegeben ist, wird das in den Player-Einstellungen festgelegte Standardbild verwendet. - `author` (string, optional) — Autor, der im Player verwendet und am Anfang des hochgeladenen Artikels eingefügt wird. Wenn nicht angegeben, wird der in den Player-Einstellungen festgelegte Standardautor verwendet. - `title` (string, optional) — Im Player verwendeter und oben im hochgeladenen Artikel eingefügter Titel. Wenn nicht angegeben, wird der in den Player-Einstellungen festgelegte Standardtitel verwendet. - `small` (boolean, optional) — (Veraltet) Ob der kleine Player verwendet werden soll. Wenn nicht angegeben, wird der in den Player-Einstellungen festgelegte Standardwert verwendet. - `text_color` (string, optional) — Im Player verwendete Textfarbe. Falls nicht angegeben, wird die in den Player-Einstellungen festgelegte Standardtextfarbe verwendet. - `background_color` (string, optional) — Im Player verwendete Hintergrundfarbe. Wenn nicht angegeben, wird die in den Player-Einstellungen festgelegte Standardhintergrundfarbe verwendet. - `sessionization` (integer, optional) — (Veraltet) Gibt an, für wie viele Minuten die Sitzung über Seitenneuladungen hinweg erhalten bleibt. Wenn nicht angegeben, wird die in den Player-Einstellungen festgelegte Standard-Sitzungsdauer verwendet. - `voice_id` (string, optional) — Stimmen-ID zur Vertonung des Inhalts. Wenn nicht angegeben, wird die in den Player-Einstellungen festgelegte Standard-Stimmen-ID verwendet. - `model_id` (string, optional) — Im Player verwendete TTS-Modell-ID. Wenn nicht angegeben, wird die in den Player-Einstellungen festgelegte Standard-Modell-ID verwendet. - `file` (file, optional) — TXT- oder HTML-Eingabedatei mit dem Artikelinhalt. HTML sollte wie folgt formatiert sein: '<html><body><div><p>Ihr Inhalt</p><h3>Mehr von Ihrem Inhalt</h3><p>Noch mehr von Ihrem Inhalt</p></div></body></html>' - `auto_convert` (boolean, optional) — Ob das Projekt automatisch in Audio konvertiert werden soll. - `apply_text_normalization` (enum, optional) — Dieser Parameter steuert die Textnormalisierung mit vier Modi: 'auto', 'on', 'apply_english' und 'off'. Bei 'auto' entscheidet das System automatisch, ob die Textnormalisierung angewendet wird (z. B. das Ausschreiben von Zahlen). Mit 'on' wird die Textnormalisierung immer angewendet, mit 'off' wird sie übersprungen. 'apply_english' entspricht 'on', setzt jedoch englischen Text voraus. - `pronunciation_dictionary_locators` (list of string, optional) — Eine als Liste von JSON-Strings codierte Liste von Aussprachewörterbuch-Referenzen (pronunciation\_dictionary\_id, version\_id), die auf den Text angewendet werden. Eine Liste JSON-codierter Strings ist erforderlich, da Projekte über formData statt über jsonBody hinzugefügt werden können. Um mehrere Wörterbücher anzugeben, verwenden Sie mehrere --form-Zeilen in Ihrem curl, etwa --form 'pronunciation\_dictionary\_locators="\{"pronunciation\_dictionary\_id":"Vmd4Zor6fplcA7WrINey","version\_id":"hRPaxjlTdR7wFMhV4w0b"}"' --form 'pronunciation\_dictionary\_locators="\{"pronunciation\_dictionary\_id":"JzWtcGQMJ6bnlWwyMo7e","version\_id":"lbmwxiLu4q6txYxgdZqn"}"'. ## Response ### 200 Erfolgreiche Antwort - `project_id` (string, required) — Die ID des erstellten Audio Native-Projekts. - `converting` (boolean, required) — Gibt an, ob das Projekt derzeit konvertiert wird. - `html_snippet` (string, required) — Das HTML-Snippet zum Einbetten des Audio Native-Players. ## Errors ### 422 Unprocessable Entity Error Validierungsfehler - `detail` (list of ValidationError, optional) ## Types ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### ValidationErrorLocItems ## Examples **Request** ```json { "file": ">", "name": "string" } ``` **Response** ```json { "project_id": "JBFqnCBsd6RMkjVDRZzb", "converting": false, "html_snippet": "
" } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/audio-native" files = { "file": "open('', 'rb')" } payload = { "apply_text_normalization": , "author": , "auto_convert": , "background_color": , "image": , "model_id": , "name": "string", "pronunciation_dictionary_locators": , "sessionization": , "small": , "text_color": , "title": , "voice_id": } response = requests.post(url, data=payload, files=files) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/audio-native'; const form = new FormData(); form.append('apply_text_normalization', ''); form.append('author', ''); form.append('auto_convert', ''); form.append('background_color', ''); form.append('file', ''); form.append('image', ''); form.append('model_id', ''); form.append('name', 'string'); form.append('pronunciation_dictionary_locators', ''); form.append('sessionization', ''); form.append('small', ''); form.append('text_color', ''); form.append('title', ''); form.append('voice_id', ''); 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/audio-native" payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"apply_text_normalization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"author\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"background_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"name\"\r\n\r\nstring\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pronunciation_dictionary_locators\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"sessionization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"small\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"text_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\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/audio-native") 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=\"apply_text_normalization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"author\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"background_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"name\"\r\n\r\nstring\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pronunciation_dictionary_locators\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"sessionization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"small\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"text_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\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/audio-native") .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"apply_text_normalization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"author\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"background_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"name\"\r\n\r\nstring\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pronunciation_dictionary_locators\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"sessionization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"small\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"text_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/audio-native', [ 'multipart' => [ [ 'name' => 'file', 'filename' => '', 'contents' => null ], [ 'name' => 'name', 'contents' => 'string' ] ] ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/audio-native"); var request = new RestRequest(Method.POST); request.AddParameter("undefined", "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"apply_text_normalization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"author\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"background_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"name\"\r\n\r\nstring\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pronunciation_dictionary_locators\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"sessionization\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"small\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"text_color\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n\r\n-----011000010111000001101001--\r\n", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let parameters = [ [ "name": "apply_text_normalization", "value": ], [ "name": "author", "value": ], [ "name": "auto_convert", "value": ], [ "name": "background_color", "value": ], [ "name": "file", "fileName": "" ], [ "name": "image", "value": ], [ "name": "model_id", "value": ], [ "name": "name", "value": "string" ], [ "name": "pronunciation_dictionary_locators", "value": ], [ "name": "sessionization", "value": ], [ "name": "small", "value": ], [ "name": "text_color", "value": ], [ "name": "title", "value": ], [ "name": "voice_id", "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/audio-native")! 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() ```