tts-1
TTS-1 omdanner forberedt tekst til talt lyd med valgbare stemmer, afspilningshastighed og outputformater. OpenAI optimerer denne udgave til talegenerering med lavere svartid, hvilket gør den til et praktisk valg til hurtige oplæsninger, kort fortælling og streamet levering af et allerede skrevet manuskript.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
TTS-1 er OpenAI's tekst-til-tale-model optimeret til hastighed. Den modtager de ord, der skal siges, og producerer lyd frem for en transskription eller et skrevet svar. Producentens eksempler omfatter oplæsning af skrevne artikler, produktion af tale på flere sprog og afspilning af lyd, efterhånden som den ankommer. TTS-1 har lavere svartid end TTS-1 HD; HD-modellen lægger vægt på outputkvalitet. Den nyttige beslutning er derfor, om hurtig afspilning eller fortællerprofilen med højere kvalitet betyder mest for opgaven.
Arbejdsgangen til talegenerering er bygget omkring modellen, inputteksten og den valgte stemme. OpenAI's reference begrænser tekstinputtet til 4096 tegn, en tegngrænse frem for et tokenkontekstvindue. Forbered det faktiske manuskript før syntese: skriv de sætninger, lytteren skal høre, afklar forkortelser, og afgør, hvordan navne, mængder og overskrifter skal udtales. Til en lang artikel skal afsnit organiseres i passager, der kan forstås selvstændigt, frem for at behandle et langt dokument som én taleanmodning.
OpenAI's aktuelle modelspecifikke stemmeliste til TTS-1 er alloy, ash, coral, echo, fable, onyx, nova, sage og shimmer. Det er forudindstillede stemmer; de er ikke det fulde stemmesæt for enhver nyere talemodel. Stemmerne er optimeret til engelsk, mens flersproget tale understøttes ved at levere inputtet på det sprog, der skal tales. Vælg en stemme ved hjælp af en repræsentativ passage med samme ordforråd og tempo som det færdige manuskript. Behold valget i beslægtede klip, når kontinuitet er vigtig.
Lyd kan streames i bidder, så afspilningen begynder, før hele filen er færdiggenereret. Det er streaming af tale skabt fra tekst, ikke en tovejs-talesamtale. De dokumenterede outputformater er MP3, Opus, AAC, FLAC, WAV og PCM med MP3 som standard. MP3 og AAC giver komprimeret lyd; Opus egner sig til streaming og kommunikation; FLAC er tabsfrit. WAV undgår afkodning af komprimeret lyd, og rå PCM indeholder samples ved 24 kHz, 16-bit signed little-endian, uden filheader. OpenAI anbefaler WAV eller PCM, når svartid prioriteres.
API-referencen for talegenerering stiller en hastighedsindstilling fra 0.25 til 4.0 til rådighed med 1.0 som standard. Det ekstra felt til instruktioner i naturligt sprog virker ikke med TTS-1, og hændelsesbaseret SSE-output understøttes ikke for denne model. Dens dokumenterede kontroller er manuskript, stemme, hastighed og lydformat; nyere modellers kontroller til accent, følelse eller hvisken skal ikke knyttes til denne udgave. Når et klip forberedes, skal hastigheden vælges efter forståelighed, og de gengivne ord og pauser derefter undersøges frem for at antage, at manuskriptets tegnantal fastlægger en præcis varighed.
Sprogvejledningen omfatter engelsk, russisk, ukrainsk, fransk, tysk, spansk, portugisisk, italiensk, arabisk, kinesisk, japansk, koreansk, hindi, kasakhisk og mange andre sprog. Talen følger den leverede teksts sprog. En flersproget fortællerbrief starter derfor med det oversatte manuskript og den tilsigtede målgruppe; tekst-til-tale er et gengivelsestrin, ikke en instruktion om at oversætte eller omskrive teksten. Til en praktisk meddelelse skal den præcise besked og navnene forberedes. Til undervisningsfortælling skal afsnitsgrænser og definitioner være tydelige i de ord, som læses op.
En færdig leverance kan være en kort talt instruktion, en fortalt passage eller et lydsegment til en større redigering. Gennemgå udtale, fuldstændighed, tempo og det valgte format med det faktiske output. Gem manuskriptet sammen med lyden, så senere rettelser kan afgrænses til den berørte passage. OpenAI's vejledning kræver, at lyttere tydeligt får at vide, at stemmen er AI-genereret. Den oplysning hører til lytteoplevelsen; den gør ikke TTS-1 til en optagelse af en menneskestemme og tilføjer ikke stemmekloningskontroller til modellen.
Ailoot Ultra · Oplæsning POST /v1/audio/speech openai/tts-1
openai/tts-1Start
TTS-1 omdanner forberedt tekst til talt lyd med valgbare stemmer, afspilningshastighed og outputformater. OpenAI optimerer denne udgave til talegenerering med lavere svartid, hvilket gør den til et praktisk valg til hurtige oplæsninger, kort fortælling og streamet levering af et allerede skrevet manuskript.
- Accepterede input
- Tekst
- Resultater
- Lyd
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Oplæsning POST /v1/audio/speech
- Inputtyper
text- Outputtyper
audio- Outputformat
- mp3
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser openai/tts-1 | Standard— |
Feltinput | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 Maksimal længde: 4.096 Enhed: Unicode-tegn | Standard— |
Feltvoice | Typestring | KravPåkrævet | Værdier og grænser alloy | Standard— |
Kombinationer af inputmaterialer
text_to_speech · Påkrævet: input
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, input, voice |
Parametervoice_ids | Kontraktalloy |
Parametermax_input_characters | Kontrakt4096 |
Parameterother_options | Kontraktfalse |
Parameterinput | Kontraktpræcis UTF-8-tekst; antal Unicode-tegn uden normalisering |
Parametermaterial_types | Kontrakttext |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Vælg den præcise stemme fra denne modelprofil.
Inputtegn og lydsekunder er forskellige måleenheder.
Priser
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Ailoot-takster
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Afregningsmængde | Afregnet mængde | Afregningsenhed | Beløb |
|---|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Afregningsmængde— | Afregnet mængde— | Afregningsenhed— | Beløb Input · Inputtokens — / 1K tokens Output · Outputtokens — / 1K tokens Input · Cachelæsning — / 1K tokens Input · Cacheskrivning — / 1K tokens Input · Cacheskrivning, 1 time — / 1K tokens |
| KonfigurationUltra | Takstplan— | AfregningsmængdeHvert Unicode-kodepunkt tæller som ét tegn, herunder Han-tegn. | Afregnet mængde— | Afregningsenhedpr. 1K inputtegn | Beløb Input · inputtegn $0.03 pr. 1K inputtegn |
| KonfigurationPr. forespørgsel | Takstplan— | Afregningsmængde— | Afregnet mængdeén forespørgsel | Afregningsenhed— | Beløb Input $0 pr. anmodning |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Oplæsning
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
Hent og gem resultater
Ailoot Ultra · Oplæsning
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
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
Behold alle færdige resultater
Gem hvert fuldstændigt returneret svar, hver fil og hver indholdsdel.
Gem hele det binære resultat og alle headere. Hvis der returneres JSON eller flere output, skal du gemme hvert dataelement og hente alle de faktiske signerede asset-URL'er.
Hvis det oprindelige svar skal kontrolleres
Gem det oprindelige operation_id/X-Client-Request-ID til afstemning uden genindsendelse; der er ingen særskilt rute til polling af lyd.
Svarfelter
| Felt | Type |
|---|---|
Feltbinary audio | Typebytes |
Feltresponse headers | Typeheaders |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldige obligatoriske felter, materialerepræsentation eller parameterværdi | Næste trinRet de angivne felter før en ny oprettelsesanmodning. |
Svarserver_error | BetingelseDet returnerede svar angiver, at operationen eller resultatet skal kontrolleres | Næste trinGem det oprindeligt returnerede operations-/opgave-ID, anmodningens headere og svaret; fortsæt med de understøttede læseanmodninger for den oprindelige operation. Send ikke oprettelsesanmodningen igen. |
Aliaser
Modelaliaser
Ailoot Ultra openai/tts-1
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · tts-1
- Hvilke input og resultater er tilgængelige?
POST /v1/audio/speech·openai/tts-1:text→audio- Hvilke felter bruger anmodningen?
POST /v1/audio/speech·openai/tts-1:model,input,voice- Hvilke grænser gælder?
POST /v1/audio/speech·openai/tts-1:input.maximum_length:4096