Crea progetto Studio
Crea un nuovo progetto Studio, che può essere inizializzato vuoto, da un documento o da un URL.
Header
Richiesta
Il voice_id corrispondente alla voce predefinita usata per i nuovi titoli.
Il voice_id corrispondente alla voce predefinita usata per i nuovi paragrafi.
L’ID del modello da usare per questo progetto Studio. Puoi eseguire una query GET /v1/models per elencare tutti i modelli disponibili.
Un URL facoltativo da cui estrarremo il contenuto per inizializzare il progetto Studio. Se questo valore è impostato, ‘from_url’ e ‘from_content’ devono essere null. Se non vengono forniti ‘from_url’, ‘from_document’ né ‘from_content’, inizializzeremo il progetto Studio vuoto.
Puoi fornire un file facoltativo .epub, .pdf, .txt o simile. Se fornito, inizializzeremo il progetto Studio con il suo contenuto. Se questo valore è impostato, ‘from_url’ e ‘from_content’ devono essere null. Se non vengono forniti ‘from_url’, ‘from_document’ né ‘from_content’, inizializzeremo il progetto Studio vuoto.
Contenuto facoltativo con cui inizializzare il progetto Studio. Se impostato, ‘from_url’ e ‘from_document’ devono essere null. Se non vengono forniti né ‘from_url’, né ‘from_document’, né ‘from_content’, inizializzeremo il progetto Studio vuoto.
Esempio: [{“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”}]}]}]
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.
Un nome facoltativo dell’autore del progetto Studio; verrà aggiunto come metadato al file mp3 durante il download del progetto Studio o del capitolo.
Una lingua facoltativa del progetto Studio. Codice lingua di due lettere (ISO 639-1).
Una data di pubblicazione originale facoltativa del progetto Studio, nel formato YYYY-MM-DD o YYYY.
Un numero ISBN facoltativo del progetto Studio che vuoi creare; verrà aggiunto come metadato al file mp3 durante il download del progetto Studio o del capitolo.
[Obsoleto] Quando il progetto Studio viene scaricato, indica se l’audio restituito deve essere sottoposto a post-elaborazione per rispettare i requisiti di volume normalizzato degli audiolibri.
Se, quando il progetto Studio viene scaricato, l’audio restituito deve avere un post-processing per rispettare i requisiti di volume normalizzato degli audiolibri
Un elenco di locator dei dizionari di pronuncia (pronunciation_dictionary_id, version_id), codificati come elenco di stringhe JSON, da applicare al testo. È richiesto un elenco di stringhe codificate in JSON poiché l’aggiunta di progetti può avvenire tramite formData anziché jsonBody. Per specificare più dizionari, usa più righe —form nel comando curl, ad esempio —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“Vmd4Zor6fplcA7WrINey”,“version_id”:“hRPaxjlTdR7wFMhV4w0b”}”’ —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“JzWtcGQMJ6bnlWwyMo7e”,“version_id”:“lbmwxiLu4q6txYxgdZqn”}”’.
Un URL che verrà chiamato dal nostro servizio quando il progetto Studio viene convertito. La richiesta conterrà un blob JSON con lo stato della conversione. Messaggi:
-
Quando il progetto è stato convertito correttamente: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “success”, project_snapshot_id: “22m00Tcm4TlvDq8ikMAT”, error_details: None, } }
-
Quando la conversione del progetto non è riuscita: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “error”, project_snapshot_id: None, error_details: “Dettagli dell’errore se la conversione non è riuscita” } }
-
Quando il capitolo è stato convertito correttamente: { 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, } }
-
Quando la conversione del capitolo non è riuscita: { 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: “Dettagli dell’errore se la conversione non è riuscita” } }
Un’indicazione facoltativa che specifica se il contenuto di questo progetto Studio è di finzione.
Questo parametro controlla la normalizzazione del testo con quattro modalità: ‘auto’, ‘on’, ‘apply_english’ e ‘off’. Se impostato su ‘auto’, il sistema deciderà automaticamente se applicare la normalizzazione del testo (ad esempio, scrivendo i numeri in lettere). Con ‘on’, la normalizzazione del testo verrà sempre applicata, mentre con ‘off’ verrà ignorata. ‘apply_english’ equivale a ‘on’, ma presume che il testo sia in inglese.
[Funzionalità alfa] Indica se assegnare automaticamente le voci alle frasi durante la creazione del progetto.
Override facoltativi delle impostazioni vocali per il progetto, codificati come elenco di stringhe JSON.
Esempio: [”{“voice_id”: “21m00Tcm4TlvDq8ikWAM”, “stability”: 0.7, “similarity_boost”: 0.8, “style”: 0.5, “speed”: 1.0, “use_speaker_boost”: true}”]