tts-1-hd
TTS-1 HD convertit du texte écrit en audio parlé de meilleure qualité avec des voix prédéfinies sélectionnables, une vitesse réglable et six formats de sortie. OpenAI positionne HD pour la qualité de narration, plutôt que pour le profil à plus faible latence de TTS-1, ce qui le rend utile aux lectures terminées, aux contenus pédagogiques et aux passages audio montés.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
TTS-1 HD est le modèle de synthèse vocale d’OpenAI optimisé pour la qualité audio. Un script préparé constitue son entrée et de l’audio parlé sa sortie. Le choix HD est distinct du profil de TTS-1 centré sur la vitesse : OpenAI décrit TTS-1 comme ayant une latence plus faible, mais une qualité inférieure. HD est donc un choix utile de narration lorsque la piste vocale terminée importe davantage que le démarrage de lecture le plus rapide possible. Un article écrit, un passage de leçon ou une explication soignée peuvent devenir un élément parlé.
Les entrées principales sont le modèle choisi, le texte exact et une voix. La référence de parole du fabricant limite le script à 4096 caractères par requête. Cela décrit la longueur d’entrée écrite, plutôt qu’une garantie de durée audio. Préparez un script compréhensible à l’écoute : développez les abréviations ambiguës, déterminez la manière de prononcer les quantités et gardez chaque passage cohérent. Pour une leçon ou un article plus longs, divisez le texte selon des limites porteuses de sens et conservez l’ordre d’utilisation des passages obtenus.
Le guide actuel d’OpenAI répertorie neuf choix intégrés pour TTS-1 HD : alloy, ash, coral, echo, fable, onyx, nova, sage et shimmer. Les voix sont optimisées pour l’anglais, tandis que le guide de synthèse vocale prend en charge la génération de parole dans plusieurs langues en fournissant du texte dans la langue requise. Une comparaison de voix est surtout utile avec un même script représentatif, comprenant les noms et le vocabulaire spécialisé qui apparaîtront dans le contenu final. Gardez la voix et la vitesse cohérentes lorsque plusieurs extraits forment une narration.
MP3 est la sortie par défaut. Opus et AAC fournissent d’autres formats audio compressés ; FLAC fournit une compression sans perte ; WAV fournit de l’audio non compressé. PCM fournit des échantillons bruts signés de 16 bits à 24 kHz en petit-boutiste, sans en-tête de fichier. Ces choix servent à différents usages : un fichier compact à distribuer, un élément en streaming ou de l’audio à transmettre à un processus de montage. OpenAI recommande WAV ou PCM pour des réponses plus rapides lorsque la surcharge de décodage compte. Choisir un format de fichier ne modifie pas le script et n’ajoute pas de modèle distinct de contrôle vocal.
La parole peut être fournie par segments, permettant à un lecteur de commencer avant que le fichier audio complet soit prêt. Il s’agit d’un streaming texte-audio ; cela n’établit pas une conversation vocale bidirectionnelle. La référence prend en charge une valeur de vitesse de 0.25 à 4.0, avec 1.0 par défaut. Le champ distinct d’instructions en langue naturelle ne fonctionne pas avec TTS-1 HD et la sortie d’événements SSE n’est pas prise en charge pour ce modèle. Le script, la voix prédéfinie, la vitesse et le format de sortie sont les commandes documentées, plutôt que l’interface de guidage d’accent ou de direction émotionnelle des modèles vocaux plus récents.
Le guide linguistique comprend notamment le russe, l’ukrainien, l’anglais, le français, l’allemand, l’espagnol, le portugais, l’italien, le chinois, le japonais, le coréen, l’arabe, l’hindi et le kazakh parmi les langues prises en charge. Préparez le script dans la langue cible ; la synthèse restitue ce texte plutôt que de le traduire. Pour un contenu pédagogique, rendez les définitions et les transitions de sections claires. Pour un passage audio explicatif, préparez le message exact et tous les noms qui doivent être entendus. L’optimisation anglaise de la voix reste pertinente lors de l’évaluation du rendu d’une langue et d’un vocabulaire particuliers.
Un processus HD concret produit un passage audio à écouter, à vérifier, puis à inclure dans le contenu terminé. Vérifiez que chaque phrase a été restituée, que les noms et les quantités ont été prononcés de manière acceptable et que le rythme choisi aide la compréhension. Préservez le script écrit avec l’audio afin qu’une correction puisse être reliée au passage pertinent. OpenAI exige une indication claire que la voix générée est artificielle. HD décrit la famille TTS orientée vers la qualité ; il ne promet pas à lui seul un calage temporel exact, une identité de locuteur personnalisée ou les commandes expressives d’un autre modèle.
Ailoot Ultra · Synthèse vocale POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdPremiers pas
TTS-1 HD convertit du texte écrit en audio parlé de meilleure qualité avec des voix prédéfinies sélectionnables, une vitesse réglable et six formats de sortie. OpenAI positionne HD pour la qualité de narration, plutôt que pour le profil à plus faible latence de TTS-1, ce qui le rend utile aux lectures terminées, aux contenus pédagogiques et aux passages audio montés.
- Entrées acceptées
- Texte
- Résultats
- Audio
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Synthèse vocale POST /v1/audio/speech
- Entrée
text- Sortie
audio- Format de sortie
- mp3
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites openai/tts-1-hd | Par défaut— |
Champinput | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 Longueur maximale: 4'096 Unité: caractères Unicode | Par défaut— |
Champvoice | Typestring | ExigenceObligatoire | Valeurs et limites alloy | Par défaut— |
Combinaisons d’éléments d’entrée
text_to_speech · Obligatoire : input
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, input, voice |
Paramètrevoice_ids | Contratalloy |
Paramètremax_input_characters | Contrat4096 |
Paramètreother_options | Contratfalse |
Paramètreinput | Contrattexte UTF-8 exact ; nombre de caractères Unicode sans normalisation |
Paramètrematerial_types | Contrattext |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Sélectionnez la voix exacte dans le profil de ce modèle.
Les caractères en entrée et les secondes d’audio sont des unités de mesure différentes.
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs Ailoot
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité facturable | Quantité facturée | Unité de facturation | Coût |
|---|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité facturable— | Quantité facturée— | Unité de facturation— | Coût Entrée · Tokens en entrée — / 1K tokens Sortie · Tokens en sortie — / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
| ConfigurationUltra | Barème tarifaire— | Quantité facturableChaque point de code Unicode compte pour un caractère, y compris les caractères Han. | Quantité facturée— | Unité de facturationpar 1K caractères en entrée | Coût Entrée · caractère en entrée $0.06 par 1K caractères en entrée |
| ConfigurationPar requête | Barème tarifaire— | Quantité facturable— | Quantité facturéeune requête | Unité de facturation— | Coût Entrée $0 par requête |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · Synthèse 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-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
Recevoir et enregistrer les résultats
Ailoot Ultra · Synthèse vocale
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Autres lectures de contenu
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
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez le résultat binaire complet et les en-têtes. Si une réponse JSON ou plusieurs sorties sont renvoyées, conservez chaque élément de données et récupérez chaque ressource via son URL signée réelle.
Si la réponse d’origine doit être vérifiée
Conservez l’operation_id/X-Client-Request-ID d’origine pour le rapprochement sans nouvelle soumission ; aucune route dédiée à l’interrogation du statut audio.
Champs de la réponse
| Champ | Type |
|---|---|
Champbinary audio | Typebytes |
Champresponse headers | Typeheaders |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Alias
Alias du modèle
Ailoot Ultra openai/tts-1-hd
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · tts-1-hd
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- Quels champs la requête utilise-t-elle ?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- Quelles limites s’appliquent ?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096