tts-1
TTS-1 converte testo preparato in audio parlato con voci, velocità di riproduzione e formati di output selezionabili. OpenAI ottimizza questa edizione per generazione vocale a latenza inferiore, rendendola una scelta concreta per letture reattive, brevi narrazioni e consegna in streaming di un copione già scritto.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
TTS-1 è il modello di sintesi vocale di OpenAI ottimizzato per la velocità. Riceve le parole da pronunciare e produce audio, anziché una trascrizione o una risposta scritta. Gli esempi del produttore comprendono narrare articoli scritti, produrre parlato in diverse lingue e riprodurre audio mentre arriva. TTS-1 è la scelta a latenza inferiore rispetto a TTS-1 HD; il modello HD privilegia la qualità di output. La decisione utile è quindi se conti di più una riproduzione pronta o un profilo narrativo di qualità superiore per l’attività.
Il flusso di generazione vocale è costruito attorno a modello, testo di input e voce selezionata. Il riferimento di OpenAI limita il testo di input a 4096 caratteri, un limite di caratteri anziché una finestra di contesto in token. Prepara il copione effettivo prima della sintesi: scrivi le frasi che l’ascoltatore dovrebbe sentire, risolvi le abbreviazioni e decidi come pronunciare nomi, quantità e titoli. Per un articolo lungo, organizza le sezioni in passaggi comprensibili indipendentemente anziché trattare un documento lungo come una sola richiesta vocale.
La lista attuale di voci di OpenAI specifica per TTS-1 è alloy, ash, coral, echo, fable, onyx, nova, sage e shimmer. Sono voci preimpostate, non l’insieme completo di voci di ogni modello vocale più recente. Le voci sono ottimizzate per l’inglese, mentre il parlato multilingue è supportato fornendo l’input nella lingua da pronunciare. Scegli una voce usando un passaggio rappresentativo con lo stesso vocabolario e ritmo del copione finale. Mantieni coerente quella scelta tra clip correlate quando conta la continuità.
L’audio può essere trasmesso in segmenti, così che la riproduzione inizi prima che l’intero file abbia finito di essere generato. È streaming di parlato creato da testo, non una conversazione parlata bidirezionale. I formati di output documentati sono MP3, Opus, AAC, FLAC, WAV e PCM, con MP3 predefinito. MP3 e AAC forniscono audio compresso; Opus è adatto a streaming e comunicazione; FLAC è senza perdita. WAV evita la decodifica di audio compresso e PCM grezzo contiene campioni a 24 kHz e 16 bit con segno little-endian senza intestazione del file. OpenAI raccomanda WAV o PCM quando è prioritario il tempo di risposta.
Il riferimento vocale fornisce un’impostazione di velocità da 0.25 a 4.0, con 1.0 predefinito. Il campo aggiuntivo di istruzioni in linguaggio naturale non funziona con TTS-1 e l’output SSE in forma di eventi non è supportato per questo modello. I controlli documentati sono copione, voce, velocità e formato audio; i controlli dei modelli più recenti per accento, emozione o sussurro non dovrebbero essere attribuiti a questa edizione. Quando prepari una clip, scegli la velocità per favorire l’intelligibilità e poi esamina parole e pause rese anziché presumere che il numero di caratteri del copione fissi una durata esatta.
La guida linguistica comprende inglese, russo, ucraino, francese, tedesco, spagnolo, portoghese, italiano, arabo, cinese, giapponese, coreano, hindi, kazako e molte altre lingue. Il parlato segue la lingua del testo fornito. Un brief narrativo multilingue parte quindi dal copione tradotto e dal pubblico previsto; la sintesi vocale è un passaggio di resa, non un’istruzione a tradurlo o riscriverlo. Per un annuncio concreto, prepara messaggio esatto e nomi. Per narrazione didattica, rendi chiari confini delle sezioni e definizioni nelle parole che verranno lette.
Un artefatto finito può essere una breve istruzione parlata, un passaggio narrato o un segmento audio per un montaggio più ampio. Verifica pronuncia, completezza, ritmo e formato scelto usando l’output effettivo. Conserva copione e audio insieme, affinché correzioni successive possano essere localizzate nel passaggio interessato. Le indicazioni di OpenAI richiedono che agli ascoltatori venga chiaramente detto che la voce è generata dall’IA. Quella comunicazione appartiene all’esperienza di ascolto; non trasforma TTS-1 in una registrazione di voce umana e non aggiunge controlli di clonazione vocale al modello.
Ailoot Ultra · Sintesi vocale POST /v1/audio/speech openai/tts-1
openai/tts-1Introduzione
TTS-1 converte testo preparato in audio parlato con voci, velocità di riproduzione e formati di output selezionabili. OpenAI ottimizza questa edizione per generazione vocale a latenza inferiore, rendendola una scelta concreta per letture reattive, brevi narrazioni e consegna in streaming di un copione già scritto.
- Input accettati
- Testo
- Risultati
- Audio
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Sintesi vocale POST /v1/audio/speech
- Tipi di input
text- Tipi di output
audio- Formato di output
- mp3
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti openai/tts-1 | Predefinito— |
Campoinput | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 Lunghezza massima: 4096 Unità: caratteri Unicode | Predefinito— |
Campovoice | Tipostring | RequisitoObbligatorio | Valori e limiti alloy | Predefinito— |
Combinazioni di materiali in input
text_to_speech · Obbligatorio: input
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, input, voice |
Parametrovoice_ids | Contrattoalloy |
Parametromax_input_characters | Contratto4096 |
Parametroother_options | Contrattofalse |
Parametroinput | Contrattotesto UTF-8 esatto; conteggio dei caratteri Unicode senza normalizzazione |
Parametromaterial_types | Contrattotext |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effettivamente restituito o record della libreria multimediale
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Seleziona la voce esatta dal profilo di questo modello.
I caratteri in ingresso e i secondi di audio sono unità di misurazione diverse.
Tariffe
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe Ailoot
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità fatturabile | Quantità fatturata | Unità di fatturazione | Costo |
|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità fatturabile— | Quantità fatturata— | Unità di fatturazione— | Costo Input · Token in input — / 1K token Output · Token in output — / 1K token Input · Lettura dalla cache — / 1K token Input · Scrittura nella cache — / 1K token Input · Scrittura nella cache, 1 ora — / 1K token |
| ConfigurazioneUltra | Listino delle tariffe— | Quantità fatturabileOgni punto di codice Unicode conta come un carattere, inclusi i caratteri Han. | Quantità fatturata— | Unità di fatturazioneper 1K caratteri in input | Costo Input · carattere in ingresso $0.03 per 1K caratteri in input |
| ConfigurazionePer richiesta | Listino delle tariffe— | Quantità fatturabile— | Quantità fatturatauna richiesta | Unità di fatturazione— | Costo Input $0 per richiesta |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Sintesi vocale
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
Ricevi e salva i risultati
Ailoot Ultra · Sintesi vocale
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Altre letture di contenuto
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
Conserva tutti i risultati completati
Conserva ogni risposta, file e parte di contenuto restituiti per intero.
Conserva il risultato binario completo e gli header. Se vengono restituiti JSON o più output, conserva ogni elemento data e recupera ogni URL firmato effettivo della risorsa.
Se occorre verificare la risposta originale
Conserva operation_id/X-Client-Request-ID originale per la riconciliazione senza reinvio; non esiste una rotta dedicata al polling audio.
Campi della risposta
| Campo | Tipo |
|---|---|
Campobinary audio | Tipobytes |
Camporesponse headers | Tipoheaders |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Alias
Alias del modello
Ailoot Ultra openai/tts-1
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · tts-1
- Quali input e risultati sono disponibili?
POST /v1/audio/speech·openai/tts-1:text→audio- Quali campi usa la richiesta?
POST /v1/audio/speech·openai/tts-1:model,input,voice- Quali limiti si applicano?
POST /v1/audio/speech·openai/tts-1:input.maximum_length:4096