tts-1

TTS-1 převádí připravený text na mluvený zvuk s volitelnými hlasy, rychlostí přehrávání a výstupními formáty. OpenAI tuto verzi optimalizuje pro generování řeči s nižší latencí, takže je praktickou volbou pro předčítání s rychlou odezvou, krátké vyprávění a streamované dodání již napsaného scénáře.

Ailoot Ultra · Převod na řeč POST /v1/audio/speech openai/tts-1

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

TTS-1 je model převodu textu na řeč od OpenAI optimalizovaný pro rychlost. Přijímá slova určená k vyslovení a vytváří zvuk, nikoli přepis nebo písemnou odpověď. Příklady výrobce zahrnují namlouvání psaných článků, tvorbu řeči v několika jazycích a přehrávání zvuku během jeho příchodu. TTS-1 je oproti TTS-1 HD volbou s nižší latencí; model HD zdůrazňuje kvalitu výstupu. Užitečným rozhodnutím proto je, zda pro úkol více záleží na pohotovém přehrávání, nebo na profilu kvalitnějšího vyprávění.

Postup generování řeči stojí na modelu, vstupním textu a vybraném hlase. Referenční příručka OpenAI omezuje textový vstup na 4096 znaků; jde o limit znaků, nikoli tokenové kontextové okno. Před syntézou připravte skutečný scénář: napište věty, které má posluchač slyšet, vyřešte zkratky a rozhodněte, jak se mají vyslovovat jména, množství a nadpisy. U dlouhého článku uspořádejte oddíly do samostatně srozumitelných pasáží, místo abyste dlouhý dokument považovali za jediný řečový požadavek.

Aktuální seznam hlasů OpenAI specifický pro TTS-1 je alloy, ash, coral, echo, fable, onyx, nova, sage a shimmer. Jde o přednastavené hlasy, nikoli o úplnou sadu hlasů všech novějších řečových modelů. Hlasy jsou optimalizovány pro angličtinu, zatímco vícejazyčná řeč je podporována dodáním vstupu v jazyce určeném k vyslovení. Hlas vyberte pomocí reprezentativní pasáže se stejnou slovní zásobou a tempem jako konečný scénář. Pokud záleží na návaznosti, tuto volbu zachovejte v souvisejících klipech.

Zvuk lze streamovat po částech, aby přehrávání začalo před dokončením generování celého souboru. Jde o streamování řeči vytvořené z textu, nikoli o obousměrnou mluvenou konverzaci. Dokumentované výstupní formáty jsou MP3, Opus, AAC, FLAC, WAV a PCM, s výchozím MP3. MP3 a AAC poskytují komprimovaný zvuk; Opus se hodí pro streamování a komunikaci; FLAC je bezeztrátový. WAV obchází dekódování komprimovaného zvuku a surový PCM obsahuje 24 kHz, 16bitové vzorky se znaménkem v pořadí little-endian bez hlavičky souboru. OpenAI doporučuje WAV nebo PCM, pokud je prioritou doba odezvy.

Referenční příručka řeči poskytuje nastavení rychlosti od 0.25 do 4.0 s výchozí hodnotou 1.0. Dodatečné pole pokynů v přirozeném jazyce s TTS-1 nefunguje a událostní výstup SSE není pro tento model podporován. Dokumentovanými ovládacími prvky jsou scénář, hlas, rychlost a zvukový formát; ovládání přízvuku, emocí či šeptání z novějších modelů nemá být připojováno k této verzi. Při přípravě klipu zvolte rychlost podporující srozumitelnost a poté zkontrolujte namluvená slova a pauzy, místo abyste předpokládali, že počet znaků scénáře určuje přesnou délku.

Jazyková příručka zahrnuje angličtinu, ruštinu, ukrajinštinu, francouzštinu, němčinu, španělštinu, portugalštinu, italštinu, arabštinu, čínštinu, japonštinu, korejštinu, hindštinu, kazaštinu a mnoho dalších jazyků. Řeč sleduje jazyk dodaného textu. Zadání vícejazyčného vyprávění proto začíná přeloženým scénářem a zamýšleným publikem; převod textu na řeč je krok přednesu, nikoli pokyn k překladu či přepsání. U praktického oznámení připravte přesnou zprávu a jména. U vzdělávacího vyprávění vyjádřete hranice oddílů a definice jasně ve slovech určených k přečtení.

Hotovým výstupem může být krátký mluvený pokyn, namluvená pasáž nebo zvukový segment pro větší sestřih. Na skutečném výstupu zkontrolujte výslovnost, úplnost, tempo a vybraný formát. Scénář uchovejte společně se zvukem, aby bylo možné pozdější opravy omezit na dotčenou pasáž. Pokyny OpenAI vyžadují, aby bylo posluchačům jasně řečeno, že hlas vytvořila AI. Toto sdělení patří k poslechovému zážitku; nemění TTS-1 na záznam lidského hlasu ani nepřidává modelu ovládání klonování hlasu.

Ailoot Ultra · Převod na řeč POST /v1/audio/speech openai/tts-1

openai/tts-1

Ostatní /openai/tts-1

Úvod

Přijímané vstupy: Text
Výsledky: Zvuk

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Převod na řeč POST /v1/audio/speech

Vstup: text
Výstup: audio
Výstupní formát: mp3

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity openai/tts-1	Výchozí—
Pole`input`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1 Maximální délka: 4 096 Jednotka: znaky Unicode	Výchozí—
Pole`voice`	Typ`string`	PožadavekPovinné	Hodnoty a limity alloy	Výchozí—

Kombinace vstupních materiálů

text_to_speech · Povinné: input

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, input, voice
Parametr`voice_ids`	Kontraktalloy
Parametr`max_input_characters`	Kontrakt4096
Parametr`other_options`	Kontraktfalse
Parametr`input`	Kontraktpřesný text UTF-8; počet znaků Unicode bez normalizace
Parametr`material_types`	Kontrakttext

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Vyberte přesný hlas z tohoto profilu modelu.

Vstupní znaky a sekundy zvuku jsou různé měrné jednotky.

Tarify

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Sazby Ailoot

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Účtované množství	Množství pro účtování	Účtovací jednotka	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Účtované množství—	Množství pro účtování—	Účtovací jednotka—	Poplatek Vstup · Vstupní tokeny — / 1K tokenů Výstup · Výstupní tokeny — / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů
KonfiguraceUltra	Tabulka sazeb—	Účtované množstvíKaždý kódový bod Unicode se počítá jako jeden znak, včetně znaků Han.	Množství pro účtování—	Účtovací jednotkaza 1K vstupních znaků	Poplatek Vstup · vstupní znak $0.03 za 1K vstupních znaků
KonfiguraceZa požadavek	Tabulka sazeb—	Účtované množství—	Množství pro účtováníjeden požadavek	Účtovací jednotka—	Poplatek Vstup $0 za požadavek

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot Ultra · Převod na řeč

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/tts-1", "input": "Good afternoon! This is a short voice take.", "voice": "alloy"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o speech.mp3

Přijímání a ukládání výsledků

Ailoot Ultra · Převod na řeč

mp3

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Další načtení obsahu

Knihovna médiíStav úlohyPodrobnosti souboru

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT

Uchovejte všechny dokončené výsledky

Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.

Uchovejte úplný binární výsledek a hlavičky. Pokud odpověď obsahuje JSON nebo více výstupů, uchovejte všechny datové položky a stáhněte každý soubor ze skutečně vrácené podepsané URL.

Pokud je nutné ověřit původní odpověď

Uchovejte původní operation_id/X-Client-Request-ID pro spárování záznamů bez opětovného odeslání; samostatná trasa pro dotazování na stav zvuku neexistuje.

Pole odpovědi

Pole	Typ
Pole`binary audio`	Typbytes
Pole`response headers`	Typheaders

Chyby a další kroky

Odpověď	Podmínka	Další krok
Odpověď400 · `invalid_request_error`	PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru	Další krokPřed novým požadavkem na vytvoření opravte uvedená pole.
Odpověď`server_error`	PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat	Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte.

Aliasy

Aliasy modelu

Ailoot Ultra openai/tts-1

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

openai/tts-1

FAQ · tts-1

Jaké vstupy a výsledky jsou dostupné?: POST /v1/audio/speech · openai/tts-1: text → audio
Jaká pole požadavek používá?: POST /v1/audio/speech · openai/tts-1: model, input, voice
Jaké limity platí?: POST /v1/audio/speech · openai/tts-1: input.maximum_length: 4096

tts-1

tts-1

Úvod

Dostupné v Ailoot · vstupy a metody

Tarify

Sazby Ailoot

Ceny podle konfigurace

Příklady požadavků

Ailoot Ultra · Převod na řeč

Přijímání a ukládání výsledků

Ailoot Ultra · Převod na řeč

Uchovejte všechny dokončené výsledky

Pokud je nutné ověřit původní odpověď

Aliasy

Aliasy modelu

Aliasy cest metod

Související ID modelů

Společnost a její portfolio projektů

Nakupujte tokeny se slevou.

Připojte API k produktu, který prodáváte.