> 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. # Genera piano di composizione POST https://api.elevenlabs.io/v1/music/plan Content-Type: application/json Crea un piano di composizione per la generazione musicale. L'uso di questo endpoint non costa crediti, ma è soggetto a rate limiting in base al tuo piano. Reference: https://elevenlabs.io/docs/api-reference/music/create-composition-plan ## 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 (application/json) This endpoint expects a Body_Generate_composition_plan_v1_music_plan_post. - `prompt` (string, required) — Un semplice prompt di testo da cui comporre un piano. - `music_length_ms` (integer, optional, nullable) — La durata del piano di composizione da generare in millisecondi. Deve essere compresa tra 3000 ms e 600000 ms. Facoltativo: se non specificata, il modello sceglierà una durata in base al prompt. - `source_composition_plan` (BodyGenerateCompositionPlanV1MusicPlanPostSourceCompositionPlan, optional, nullable) — Un piano di composizione facoltativo da usare come origine per il nuovo piano di composizione. - `model_id` (enum, optional, default: music_v1) — Il modello da usare per la generazione. - Allowed values: `music_v1`, `music_v2`, `music_v2_5` ## Response ### 200 Risposta riuscita - `music_composition_plan_create_Response_200` ## Errors ### 422 Unprocessable Entity Error Errore di convalida - `detail` (list of ValidationError, optional) ## Types ### BodyGenerateCompositionPlanV1MusicPlanPostSourceCompositionPlan Un piano di composizione facoltativo da usare come origine per il nuovo piano di composizione. ### MusicPrompt Piano di composizione per il modello `music_v1`. L'uso di questo campo con qualsiasi altro modello genererà un errore. - `positive_global_styles` (list of string, required) — Gli stili e le indicazioni musicali che devono essere presenti nell'intero brano. Per risultati migliori, usa l'inglese. - `negative_global_styles` (list of string, required) — Gli stili e le indicazioni musicali che non devono essere presenti nell'intero brano. Per risultati migliori, usa l'inglese. - `sections` (list of SongSection, required) — Le sezioni del brano. ### CompositionPlan Piano di composizione per i modelli `music_v2` e `music_v2_5`. L'uso di questo campo con qualsiasi altro modello genererà un errore. - `chunks` (list of CompositionPlanChunksItems, required) — I blocchi che compongono la generazione. ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### SongSection - `section_name` (string, required) — Il nome della sezione. Deve contenere da 1 a 100 caratteri. - `positive_local_styles` (list of string, required) — Gli stili e le indicazioni musicali che devono essere presenti in questa sezione. Per risultati migliori, usa l'inglese. - `negative_local_styles` (list of string, required) — Gli stili e le indicazioni musicali che non devono essere presenti in questa sezione. Per risultati migliori, usa l'inglese. - `duration_ms` (integer, required) — La durata della sezione in millisecondi. Deve essere compresa tra 3000 ms e 120000 ms. - `lines` (list of string, required) — Il testo della sezione. Massimo 30 righe per sezione e 200 caratteri per riga. - `source_from` (SectionSource, optional, nullable) — Origine facoltativa da cui estrarre la sezione. Usata per l'inpainting. ### CompositionPlanChunksItems ### ValidationErrorLocItems ### SectionSource - `song_id` (string, required) — L'ID del brano da cui estrarre la sezione. Puoi trovare l'ID del brano negli header della risposta quando generi un brano. - `range` (TimeRange, required) — L'intervallo da estrarre dal brano sorgente. - `negative_ranges` (list of TimeRange, optional) — Gli intervalli da escludere da 'range'. ### GenerationChunk-Input - `text` (string, required) — La configurazione del testo da generare per questo segmento. Può contenere un nome di sezione facoltativo tra parentesi quadre all'inizio, ad esempio \[Verse 1], righe di testo e indicazioni inline tra parentesi graffe, ad esempio \{scratching}. I nomi delle sezioni devono contenere da 1 a 100 caratteri. Sono consentite al massimo 30 righe, ciascuna di massimo 200 caratteri. - `duration_ms` (integer, required) — La durata del chunk in millisecondi. Deve essere compresa tra 3000 ms e 120000 ms. - `positive_styles` (list of string, required) — Gli stili e le indicazioni musicali che devono essere presenti in questo segmento. Per risultati migliori, usa l'inglese. Gli stili del primo segmento sono i più importanti perché definiscono il tono e il genere generali. Gli stili dei segmenti successivi possono aggiungere sfumature, progressione, enfasi o modificare la direzione del brano. Cerca di inserire almeno 6-7 stili nei primi segmenti, finché non è definita una direzione. Stili generici come 'great production quality' sono buone opzioni predefinite da aggiungere all'elenco. - `negative_styles` (list of string, optional) — Gli stili e le indicazioni musicali che non devono essere presenti in questo segmento. Per risultati migliori, usa l'inglese. Lasciare il campo vuoto è una buona impostazione predefinita; usalo se vuoi evitare esplicitamente uno stile o una direzione specifici. - `context_adherence` (enum, optional, default: high) — Quanto il modello aderisce al contesto dei chunk circostanti. Un'aderenza bassa significa che il modello può discostarsi dal contesto ed essere più creativo. Un'aderenza alta significa che il modello sarà più coerente con il contesto. - Allowed values: `low`, `medium`, `high` - `conditioning_ref` (AudioRefChunk, optional, nullable) — Il riferimento audio su cui condizionare la generazione. Il primo blocco è il più importante, poiché influenzerà la generazione di tutti i blocchi successivi. Pertanto, se vuoi applicare il condizionamento all'intera canzone, avvialo dal primo blocco. - `condition_strength` (enum, optional, nullable) — Quanto il modello aderisce al riferimento di condizionamento. Un'intensità bassa rende il modello più creativo e meno aderente al riferimento. Un'intensità alta rende il modello più coerente con il riferimento. - Allowed values: `low`, `medium`, `high`, `xhigh` ### AudioRefChunk - `song_id` (string, required) — L'ID del brano da cui estrarre il chunk. Puoi trovare l'ID del brano negli header della risposta quando generi un brano. - `range` (TimeRange, required) — L'intervallo di tempo da estrarre dal brano. ### TimeRange - `start_ms` (integer, required) - `end_ms` (integer, required) ## Examples **Request** ```json { "prompt": "string" } ``` **Response** ```json { "negative_global_styles": [ "metal", "hip-hop", "country" ], "positive_global_styles": [ "pop", "rock", "jazz" ], "sections": [ { "duration_ms": 10000, "lines": [ "Verse 1 lyrics" ], "negative_local_styles": [ "metal", "hip-hop", "country" ], "positive_local_styles": [ "pop", "rock", "jazz" ], "section_name": "Verse 1" } ] } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/music/plan" payload = { "prompt": "string" } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/music/plan'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"prompt":"string"}' }; 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/music/plan" payload := strings.NewReader("{\n \"prompt\": \"string\"\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/music/plan") 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 \"prompt\": \"string\"\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/music/plan") .header("Content-Type", "application/json") .body("{\n \"prompt\": \"string\"\n}") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/music/plan', [ 'body' => '{ "prompt": "string" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/music/plan"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"prompt\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = ["prompt": "string"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/music/plan")! 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() ```