> 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. # Skapa målspråk för dubbning POST https://api.elevenlabs.io/v1/dubbing/project/{project_id}/language Content-Type: application/json Lägg till ett språk att dubba ett projekt till och köa dubbningen. Det här anropet skapar dubbat ljud och debiteras per generering. Målet skapas som `queued` och startar så snart projektet är `ready`, så det kan läggas till när som helst efter att projektet har skapats. Det ärver projektets dubbningsmodell och kan inte välja en annan. Ett projekt som skapats med `webhook_ids` skickar händelsen `dubbing_language_completed` med nedladdnings-URL:er för resultatet. Vi rekommenderar därför att du prenumererar i stället för att polla målet tills det är klart. Reference: https://elevenlabs.io/docs/api-reference/dubbing/language-targets/create-language-target ## 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) — Identifierare för det överordnade dubbningsprojektet. ### Body (application/json) This endpoint expects a Body_Create_Dubbing_Language_Target_v1_dubbing_project__project_id__language_post. - `target_language` (string, required) — BCP-47-språktagg att dubba projektet till (till exempel `fr` eller `es-MX`). Måste vara ett av de [språk som projektets dubbningsmodell stöder](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing), och en regionsspecificerad tagg måste vara en av de dialekter som stöds. - `voice_settings` (VoiceSettings, optional, nullable) — Röstinställningar som tillämpas på varje talare på detta språk. Utelämna för att använda standardinställningarna. - `translations` (map from string to string, optional, nullable) — Endast Enterprise. Valfria översättningar att använda i stället för maskinöversättning. En mappning från varje källsegments `external_id` (eller dess `id`, om du inte har angett något) till den översatta texten; varje källsegment måste täckas exakt en gång. Högst 20 000 poster, med totalt högst 4 MiB text. Se [Använd din egen transkription](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript). ## Response ### 201 Lyckat svar - `language_id` (string, required) — Unik identifierare för målspråket. - `project_id` (string, required) — Identifierare för det överordnade dubbningsprojektet. - `target_language` (string, required) — BCP-47-språktagg som detta mål dubbas till. - `status` (enum, required) — Livscykelstatus: `queued` (väntar på att projektet ska bli klart eller på en arbetare), `processing` medan det dubbas, `completed` när utdata är tillgänglig, `stale` när transkriptet har ändrats efter att utdata skapades, eller `failed`. - Allowed values: `queued`, `processing`, `completed`, `stale`, `failed` - `revision` (integer, required) — Monoton räknare som ökas varje gång det här målets transkription ändras (en källredigering som påverkar den eller en ändring av dess översättning). - `created_at` (string, required) — När målspråket skapades. - `updated_at` (string, required) — När målspråket senast uppdaterades. - `model_id` (string, optional, nullable) — Dubbningsmodell som det här målet dubbas med, ärvs från projektet och kan inte väljas per språk. - `voice_settings` (VoiceSettings, optional, nullable) — Röstinställningar som tillämpas på varje talare på detta språk, eller null om standardinställningarna används. - `outputs` (DubbingLanguageOutputs, optional, nullable) — Signerade utdata-URL:er; null tills målet har producerat utdata (finns när `completed` har uppnåtts och behålls medan `stale` — jämför `output_revision` med `revision` för att avgöra om utdatan är aktuell). - `output_revision` (integer, optional, nullable) — Den `revision` som den aktuella dubbade utdatan genererades från; lika med `revision` när den är uppdaterad och lägre när den är `stale`. Detta är null tills en generering har slutförts. - `error` (DubbingError, optional, nullable) — Varför det här språket misslyckades; null om inte `status` är `failed`, och även null för de få språk som misslyckades innan felrapportering infördes. Koden `project_failed` betyder att det överordnade projektet misslyckades, så läs projektet för att se den bakomliggande orsaken. - `warnings` (list of VoicesNotPermittedWarning, optional) — Icke-kritiska villkor som uppstod vid dubbning till det här språket; tomt om inga finns. Återspeglar den senaste genereringen. Villkor som uppstår när källan förbereds rapporteras i stället för projektet. ## Errors ### 422 Unprocessable Entity Error Valideringsfel - `detail` (list of ValidationError, optional) ## Types ### VoiceSettings - `cloning_strength` (integer, optional, default: 7) — Hur starkt de dubbade talarna klonar källrösterna, från 0 till 10. ### DubbingLanguageOutputs Signerade, tidsbegränsade nedladdnings-URL:er för ett språkmåls utdata. - `lossless_audio` (string, optional, nullable) — Signerad URL för det dubbade förlustfria ljudspåret i FLAC. Länken upphör att gälla en timme efter att den utfärdats; hämta språkmålet igen för en ny länk. ### DubbingError - `message_type` ("error", required) - `error` (string, required) ### VoicesNotPermittedWarning - `type` ("voices_not_permitted", required) — Identifierar denna varning; förgrena utifrån den för att läsa de andra fälten. - `speaker_ids` (list of string, required) — Talare vars röster inte var tillåtna för kloning. Dubbningen använde en ersättningsröst för var och en av dem; alla andra talare påverkas inte. - `message` (string, required) — Människoläsbar beskrivning av varningen för visning. Formuleringen kan ändras när som helst, så vi rekommenderar att du i stället förgrenar utifrån `type`. ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### ValidationErrorLocItems ## Examples **Request** ```json { "target_language": "es" } ``` **Response** ```json { "language_id": "lang_1001kwkyxp0je6ktn4knsfrasx5s", "project_id": "proj_1601kwkyxp0hfzvtmyxwqxx6mcy3", "target_language": "es", "status": "queued", "revision": 0, "created_at": "2026-07-03T10:16:00Z", "updated_at": "2026-07-03T10:16:00Z", "model_id": "dubbing_v2", "warnings": [] } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language" payload = { "target_language": "es" } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"target_language":"es"}' }; 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/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language" payload := strings.NewReader("{\n \"target_language\": \"es\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") 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/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"target_language\": \"es\"\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/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language") .header("Content-Type", "application/json") .body("{\n \"target_language\": \"es\"\n}") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language', [ 'body' => '{ "target_language": "es" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"target_language\": \"es\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = ["target_language": "es"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3/language")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers 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() ```