tts-1
TTS-1 omvandlar förberedd text till talat ljud med valbara röster, uppspelningshastighet och utdataformat. OpenAI optimerar denna version för talgenerering med lägre latens, vilket gör den praktisk för uppläsningar med snabb respons, kort berättarröst och strömmande leverans av ett redan skrivet manus.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
TTS-1 är OpenAI:s text-till-tal-modell som är optimerad för hastighet. Den tar emot de ord som ska uttalas och skapar ljud, snarare än en transkription eller ett skrivet svar. Tillverkarens exempel omfattar uppläsning av skrivna artiklar, talproduktion på flera språk och uppspelning av ljud medan det kommer in. TTS-1 är valet med lägre latens jämfört med TTS-1 HD; HD-modellen betonar utdatakvalitet. Det användbara beslutet är därför om snabb uppspelning eller berättarröstprofilen med högre kvalitet är viktigare för uppgiften.
Arbetsflödet för talgenerering bygger på modellen, indatatexten och den valda rösten. OpenAI:s referens begränsar textindata till 4096 tecken, en teckengräns snarare än ett tokenbaserat kontextfönster. Förbered det faktiska manuset före syntesen: skriv meningarna lyssnaren ska höra, lös upp förkortningar och avgör hur namn, mängder och rubriker ska uttalas. Organisera avsnitten i en lång artikel till självständigt begripliga delar i stället för att behandla ett långt dokument som en enda talbegäran.
OpenAI:s aktuella modellspecifika röstlista för TTS-1 är alloy, ash, coral, echo, fable, onyx, nova, sage och shimmer. Det är förinställda röster; de utgör inte hela röstuppsättningen för varje nyare talmodell. Rösterna är optimerade för engelska, medan flerspråkigt tal stöds genom att indata anges på det språk som ska uttalas. Välj röst med ett representativt avsnitt med samma ordförråd och tempo som slutmanuset. Håll valet konsekvent mellan relaterade klipp när kontinuitet är viktig.
Ljud kan strömmas i delar så att uppspelningen börjar innan hela filen har genererats. Det är strömning av tal som skapats från text, inte ett dubbelriktat talat samtal. De dokumenterade utdataformaten är MP3, Opus, AAC, FLAC, WAV och PCM, med MP3 som standard. MP3 och AAC ger komprimerat ljud; Opus passar för strömning och kommunikation; FLAC är förlustfritt. WAV undviker avkodning av komprimerat ljud och rå PCM innehåller 16-bitars sampel med tecken i little-endian-format vid 24 kHz utan filhuvud. OpenAI rekommenderar WAV eller PCM när svarstid prioriteras.
Talreferensen ger en hastighetsinställning från 0.25 till 4.0, med 1.0 som standard. Det extra instruktionsfältet för naturligt språk fungerar inte med TTS-1, och händelsebaserade SSE-utdata stöds inte för denna modell. Dess dokumenterade kontroller är manus, röst, hastighet och ljudformat; nyare modellers kontroller för accent, känsla eller viskning ska inte tillskrivas denna version. Välj hastighet som stödjer begriplighet när du förbereder ett klipp och granska sedan återgivna ord och pauser i stället för att anta att manusets teckenantal fastställer en exakt längd.
Språkguiden omfattar engelska, ryska, ukrainska, franska, tyska, spanska, portugisiska, italienska, arabiska, kinesiska, japanska, koreanska, hindi, kazakiska och många andra språk. Talet följer språket i den angivna texten. Ett uppdrag för flerspråkig berättarröst börjar därför med det översatta manuset och den avsedda publiken; text-till-tal är ett återgivningssteg, inte en instruktion att översätta eller skriva om. Förbered det exakta meddelandet och namnen för ett praktiskt utrop. Gör avsnittsgränser och definitioner tydliga i orden som ska läsas upp för pedagogisk berättarröst.
En färdig leverans kan vara en kort talad instruktion, ett uppläst avsnitt eller ett ljudsegment för en större redigering. Granska uttal, fullständighet, tempo och valt format med de faktiska utdata. Spara manuset tillsammans med ljudet så att senare korrigeringar kan lokaliseras till det berörda avsnittet. OpenAI:s vägledning kräver att lyssnare tydligt informeras om att rösten är AI-genererad. Informationen hör till lyssnarupplevelsen; den gör inte TTS-1 till en inspelning av en mänsklig röst och lägger inte till röstkloningskontroller i modellen.
Ailoot Ultra · Talproduktion POST /v1/audio/speech openai/tts-1
openai/tts-1Start
TTS-1 omvandlar förberedd text till talat ljud med valbara röster, uppspelningshastighet och utdataformat. OpenAI optimerar denna version för talgenerering med lägre latens, vilket gör den praktisk för uppläsningar med snabb respons, kort berättarröst och strömmande leverans av ett redan skrivet manus.
- Godkända indata
- Text
- Resultat
- Ljud
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Talproduktion POST /v1/audio/speech
- Indatatyper
text- Utdatatyper
audio- Utdataformat
- mp3
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser openai/tts-1 | Standard— |
Fältinput | Typstring | KravObligatoriskt | Värden & gränser Minsta längd: 1 Maximal längd: 4 096 Enhet: Unicode-tecken | Standard— |
Fältvoice | Typstring | KravObligatoriskt | Värden & gränser alloy | Standard— |
Kombinationer av indatamaterial
text_to_speech · Krävs: input
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, input, voice |
Parametervoice_ids | Avtalalloy |
Parametermax_input_characters | Avtal4096 |
Parameterother_options | Avtalfalse |
Parameterinput | Avtalexakt UTF-8-text; antal Unicode-tecken utan normalisering |
Parametermaterial_types | Avtaltext |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Välj den exakta rösten från denna modellprofil.
Indatatecken och ljudsekunder är olika mätenheter.
Priser
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Ailoot-priser
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Debiterbar mängd | Debiteringsmängd | Debiteringsenhet | Avgift |
|---|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Debiterbar mängd— | Debiteringsmängd— | Debiteringsenhet— | Avgift Indata · Indatatoken — / 1K token Utdata · Utdatatoken — / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token |
| KonfigurationUltra | Prislista— | Debiterbar mängdVarje Unicode-kodpunkt räknas som ett tecken, även Han-tecken. | Debiteringsmängd— | Debiteringsenhetper 1K indatatecken | Avgift Indata · indatatecken $0.03 per 1K indatatecken |
| KonfigurationPer begäran | Prislista— | Debiterbar mängd— | Debiteringsmängden förfrågan | Debiteringsenhet— | Avgift Indata $0 per begäran |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Talproduktion
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
Ta emot och spara resultat
Ailoot Ultra · Talproduktion
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andra innehållsläsningar
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
Behåll alla färdiga resultat
Behåll varje fullständigt returnerat svar, fil och innehållsdel.
Spara hela det binära resultatet och dess headers. Om JSON eller flera resultat returneras ska du behålla varje dataobjekt och hämta innehållet via varje faktisk signerad URL till en resurs.
Om det ursprungliga svaret behöver kontrolleras
Behåll de ursprungliga värdena för operation_id/X-Client-Request-ID för avstämning utan att skicka förfrågan igen; det finns ingen särskild rutt för statusavläsning av ljud.
Svarsfält
| Fält | Typ |
|---|---|
Fältbinary audio | Typbytes |
Fältresponse headers | Typheaders |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Alias
Modellalias
Ailoot Ultra openai/tts-1
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · tts-1
- Vilka indata och resultat finns?
POST /v1/audio/speech·openai/tts-1:text→audio- Vilka fält använder begäran?
POST /v1/audio/speech·openai/tts-1:model,input,voice- Vilka gränser gäller?
POST /v1/audio/speech·openai/tts-1:input.maximum_length:4096