tts-1-hd
TTS-1 HD convierte texto escrito en audio hablado de mayor calidad con voces predefinidas seleccionables, velocidad y seis formatos de salida. OpenAI orienta HD a la calidad de narración frente al perfil de menor latencia de TTS-1, por lo que resulta útil para lecturas terminadas, materiales educativos y pasajes de audio editados.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
TTS-1 HD es el modelo de texto a voz de OpenAI optimizado para la calidad de audio. Recibe un guion preparado y devuelve audio hablado. La opción HD se distingue del perfil de TTS-1 centrado en velocidad: OpenAI describe TTS-1 como de menor latencia, pero también de menor calidad. Por eso HD resulta útil para narrar cuando importa más la pista de voz terminada que iniciar la reproducción lo antes posible. Un artículo escrito, un pasaje de una lección o una explicación pulida pueden convertirse en un recurso hablado.
Las entradas principales son el modelo elegido, el texto exacto y una voz. La referencia de voz del fabricante limita el guion a 4096 caracteres por solicitud. Esto describe la longitud del texto escrito, no garantiza una duración de audio. Prepara un guion comprensible al escucharlo: desarrolla abreviaturas ambiguas, decide cómo pronunciar las cantidades y mantén coherente cada pasaje. Para una lección o artículo largo, divide el texto en puntos con sentido y conserva el orden de uso de los pasajes resultantes.
La guía actual de OpenAI enumera nueve opciones integradas para TTS-1 HD: alloy, ash, coral, echo, fable, onyx, nova, sage y shimmer. Las voces están optimizadas para inglés, mientras que la guía de texto a voz permite generar habla en varios idiomas al proporcionar texto en el idioma requerido. Comparar voces resulta más útil con el mismo guion representativo, incluidos los nombres y el vocabulario especializado del material final. Mantén constantes la voz y la velocidad cuando varios clips formen una sola narración.
MP3 es la salida predeterminada. Opus y AAC ofrecen formatos alternativos de audio comprimido; FLAC ofrece compresión sin pérdida y WAV, audio sin comprimir. PCM proporciona muestras sin procesar de 24 kHz, 16 bits con signo y orden little-endian, sin encabezado de archivo. Estas opciones cubren usos distintos: un archivo compacto para distribuir, un recurso para streaming o audio para un flujo de edición. OpenAI recomienda WAV o PCM para respuestas más rápidas cuando importa el costo de decodificación. Elegir un formato de archivo no cambia el guion ni añade un modelo independiente de control de voz.
La voz puede entregarse por bloques, de modo que un reproductor empiece antes de que esté listo el archivo completo. Se trata de streaming de texto a audio; no establece una conversación de voz bidireccional. La referencia admite una velocidad de 0.25 a 4.0, con 1.0 como valor predeterminado. El campo independiente de instrucciones en lenguaje natural no funciona con TTS-1 HD y este modelo no admite salida de eventos SSE. Los controles documentados son el guion, la voz predefinida, la velocidad y el formato de salida, en lugar de la interfaz de los modelos de voz más recientes que permite indicar acento o dirección emocional mediante instrucciones.
La guía de idiomas incluye ruso, ucraniano, inglés, francés, alemán, español, portugués, italiano, chino, japonés, coreano, árabe, hindi y kazajo entre los idiomas compatibles. Prepara el guion en el idioma de destino; la síntesis reproduce ese texto en vez de traducirlo. En contenido educativo, aclara las definiciones y transiciones entre secciones. Para un pasaje de audio explicativo, prepara el mensaje exacto y los nombres que deben escucharse. La optimización de la voz para inglés sigue siendo relevante al evaluar cómo suenan un idioma y vocabulario concretos.
Un flujo práctico con HD produce un pasaje de audio para escucharlo, revisarlo e incorporarlo después al material terminado. Comprueba que se reprodujeron todas las frases, que los nombres y cantidades se pronunciaron de forma aceptable y que el ritmo elegido facilita la comprensión. Conserva el guion escrito junto al audio para localizar una corrección en el pasaje correspondiente. OpenAI exige informar claramente que la voz generada es artificial. HD describe la familia TTS orientada a calidad; por sí sola no promete tiempos exactos, una identidad de hablante personalizada ni los controles expresivos de otro modelo.
Ailoot Ultra · Síntesis de voz POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdInicio
TTS-1 HD convierte texto escrito en audio hablado de mayor calidad con voces predefinidas seleccionables, velocidad y seis formatos de salida. OpenAI orienta HD a la calidad de narración frente al perfil de menor latencia de TTS-1, por lo que resulta útil para lecturas terminadas, materiales educativos y pasajes de audio editados.
- Entradas aceptadas
- Texto
- Resultados
- Audio
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Síntesis de voz POST /v1/audio/speech
- Entrada
text- Salida
audio- Formato de salida
- mp3
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites openai/tts-1-hd | Predeterminado— |
Campoinput | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 Longitud máxima: 4,096 Unidad: caracteres Unicode | Predeterminado— |
Campovoice | Tipostring | RequisitoObligatorio | Valores y límites alloy | Predeterminado— |
Combinaciones de materiales de entrada
text_to_speech · Obligatorio: input
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, input, voice |
Parámetrovoice_ids | Contratoalloy |
Parámetromax_input_characters | Contrato4096 |
Parámetroother_options | Contratofalse |
Parámetroinput | Contratotexto UTF-8 exacto; conteo de caracteres Unicode sin normalización |
Parámetromaterial_types | Contratotext |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · El task_id real devuelto o el registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Selecciona una voz exacta de este perfil de modelo.
Los caracteres de entrada y los segundos de audio se miden por separado.
Tarifas
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default
Tarifas de Ailoot
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad facturable | Cantidad para facturación | Unidad de facturación | Cargo |
|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad facturable— | Cantidad para facturación— | Unidad de facturación— | Cargo Entrada · Tokens de entrada — / 1K tokens Salida · Tokens de salida — / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
| ConfiguraciónUltra | Tabla de tarifas— | Cantidad facturableCada punto de código Unicode cuenta como un carácter, incluidos los caracteres Han. | Cantidad para facturación— | Unidad de facturaciónpor 1K caracteres de entrada | Cargo Entrada · carácter de entrada $0.06 por 1K caracteres de entrada |
| ConfiguraciónPor solicitud | Tabla de tarifas— | Cantidad facturable— | Cantidad para facturaciónuna solicitud | Unidad de facturación— | Cargo Entrada $0 por solicitud |
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Síntesis de voz
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-hd", "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
Recibir y guardar resultados
Ailoot Ultra · Síntesis de voz
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Otras consultas de contenido
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 todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva el resultado binario completo y los encabezados. Si se devuelve JSON o varias salidas, conserva cada elemento de data y descarga cada recurso desde su URL firmada real.
Si es necesario revisar la respuesta original
Conserva el operation_id/X-Client-Request-ID original para la conciliación sin volver a enviar la solicitud; no hay una ruta específica para consultar el estado del audio.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campobinary audio | Tipobytes |
Camporesponse headers | Tipoheaders |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra openai/tts-1-hd
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · tts-1-hd
- ¿Qué entradas y resultados están disponibles?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- ¿Qué campos utiliza la solicitud?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- ¿Qué límites se aplican?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096