Utwórz projekt Studio
Tworzy nowy projekt Studio, który można zainicjować jako pusty, z dokumentu lub z adresu URL.
Nagłówki
Żądanie
Nazwa projektu Studio używana tylko do identyfikacji.
voice_id odpowiadające domyślnemu głosowi używanemu w nowych tytułach.
voice_id odpowiadające domyślnemu głosowi używanemu w nowych akapitach.
ID modelu do użycia w tym projekcie Studio; użyj GET /v1/models, aby wyświetlić wszystkie dostępne modele.
Opcjonalny URL, z którego pobierzemy treść do inicjalizacji projektu Studio. Jeśli ta wartość jest ustawiona, „from_url” i „from_content” muszą mieć wartość null. Jeśli nie podasz „from_url”, „from_document” ani „from_content”, zainicjalizujemy pusty projekt Studio.
Możesz podać opcjonalny plik .epub, .pdf, .txt lub podobny. Jeśli go podasz, zainicjalizujemy projekt Studio jego treścią. Jeśli ta wartość jest ustawiona, „from_url” i „from_content” muszą mieć wartość null. Jeśli nie podasz „from_url”, „from_document” ani „from_content”, zainicjalizujemy pusty projekt Studio.
Opcjonalna zawartość, która posłuży do inicjalizacji projektu Studio. Jeśli ją podasz, ‘from_url’ i ‘from_document’ muszą mieć wartość null. Jeśli nie podasz żadnego z pól ‘from_url’, ‘from_document’ ani ‘from_content’, zainicjalizujemy pusty projekt Studio.
Przykład: [{“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.
Opcjonalne imię i nazwisko autora projektu Studio. Zostanie dodane jako metadane do pliku MP3 pobieranego dla projektu Studio lub rozdziału.
Opcjonalna lista gatunków powiązanych z projektem Studio.
Opcjonalny język projektu Studio. Dwuliterowy kod języka (ISO 639-1).
Opcjonalny typ treści projektu Studio.
Opcjonalna data pierwszej publikacji projektu Studio w formacie YYYY-MM-DD lub YYYY.
Opcjonalne określenie, czy ten projekt Studio zawiera treści dla dorosłych.
Opcjonalny numer ISBN tworzonego projektu Studio. Zostanie dodany jako metadane do pliku MP3 pobieranego dla projektu Studio lub rozdziału.
[Wycofane] Określa, czy po pobraniu projektu Studio zwrócone audio powinno przejść postprocessing, aby spełniało wymagania dotyczące znormalizowanej głośności audiobooków.
Czy podczas pobierania projektu Studio zwrócone audio powinno być poddane postprocessingowi, aby spełniało wymagania dotyczące znormalizowanej głośności audiobooków
Lista lokalizatorów słowników wymowy (pronunciation_dictionary_id, version_id) zakodowanych jako lista ciągów JSON dla słowników wymowy stosowanych do tekstu. Lista ciągów zakodowanych w JSON jest wymagana, ponieważ projekty można dodawać przez formData zamiast jsonBody. Aby podać kilka słowników, użyj kilku wierszy —form w curl, na przykład —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“Vmd4Zor6fplcA7WrINey”,“version_id”:“hRPaxjlTdR7wFMhV4w0b”}”’ —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“JzWtcGQMJ6bnlWwyMo7e”,“version_id”:“lbmwxiLu4q6txYxgdZqn”}”’.
Adres URL wywoływany przez naszą usługę po przekonwertowaniu projektu Studio. Żądanie będzie zawierać obiekt JSON ze statusem konwersji. Komunikaty:
-
Gdy projekt został pomyślnie przekonwertowany: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “success”, project_snapshot_id: “22m00Tcm4TlvDq8ikMAT”, error_details: None, } }
-
Gdy konwersja projektu się nie powiodła: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “error”, project_snapshot_id: None, error_details: “Szczegóły błędu, jeśli konwersja się nie powiodła” } }
-
Gdy rozdział został pomyślnie przekonwertowany: { 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, } }
-
Gdy konwersja rozdziału się nie powiodła: { 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: “Szczegóły błędu, jeśli konwersja się nie powiodła” } }
Opcjonalne określenie, czy treść tego projektu Studio jest fikcją.
Ten parametr steruje normalizacją tekstu w czterech trybach: ‘auto’, ‘on’, ‘apply_english’ i ‘off’. Przy wartości ‘auto’ system automatycznie zdecyduje, czy zastosować normalizację tekstu (np. zapis liczb słownie). Przy ‘on’ normalizacja tekstu będzie zawsze stosowana, a przy ‘off’ zostanie pominięta. ‘apply_english’ działa tak samo jak ‘on’, ale zakłada, że tekst jest po angielsku.
Czy automatycznie konwertować projekt Studio na audio.
[Funkcja alfa] Określa, czy automatycznie przypisywać głosy do fraz podczas tworzenia projektu.
Opcjonalne nadpisania ustawień głosu dla projektu, zakodowane jako lista ciągów JSON.
Przykład: [”{“voice_id”: “21m00Tcm4TlvDq8ikWAM”, “stability”: 0.7, “similarity_boost”: 0.8, “style”: 0.5, “speed”: 1.0, “use_speaker_boost”: true}”]
Jeśli ma wartość true, tworzy odpowiadający odczyt do bezpośredniej publikacji w stanie wersji roboczej.
Odpowiedź
Pomyślna odpowiedź