AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro est le modèle de reconnaissance vocale d’AssemblyAI qui transforme un court clip audio en transcription complète en une réponse. Son profil Sync ajoute la confiance par mot, les horodatages facultatifs des mots, les indications de vocabulaire et le contexte de conversation antérieure pour la saisie vocale et les parcours push-to-talk.
À 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.
Universal-3.5 Pro est le modèle de reconnaissance vocale d’AssemblyAI pour convertir la parole enregistrée en texte. Dans son profil Sync, un court clip audio produit une transcription complète en une réponse. Cela convient aux messages vocaux, à la saisie push-to-talk et aux tours de conversation distincts où l’application sait déjà quand l’enregistrement doit se terminer.
Préparez l’audio comme un clip délimité. Les exigences Sync d’AssemblyAI acceptent des durées de 80 millisecondes à 120 secondes, avec une taille de fichier maximale de 40 MB. Les formats pris en charge sont WAV ou PCM brut signé 16 bits little-endian. L’audio peut être mono ou stéréo, la stéréo étant convertie en mono en interne. Les fréquences d’échantillonnage prises en charge sont 8, 16, 22.05, 24, 32, 44.1 et 48 kHz. Un en-tête WAV fournit la fréquence d’échantillonnage et le nombre de canaux ; le PCM brut nécessite ces valeurs séparément dans la configuration de transcription.
Capturez l’énoncé complet et gardez intacts le début et la fin de la parole. Un exemple de tâche originale utile est un court message vocal d’assistance produit contenant un nom de produit, un identifiant de commande et une demande. Conservez le clip source pour vérifier la transcription selon ces détails importants. Pour un enregistrement plus long, préparez un parcours adapté à la transcription longue plutôt que de traiter la limite de durée des clips courts comme une capacité audio générale du modèle.
Le résultat contient la transcription complète, une liste de mots avec une confiance par mot et une confiance globale entre zéro et un. Il fournit aussi la durée de l’audio soumis et un identifiant de demande, permettant de garder le texte associé à son clip d’origine. Utilisez la confiance par mot pour repérer les passages qui méritent une réécoute, notamment les noms, nombres et termes métier importants pour l’application.
Les horodatages des mots sont facultatifs et désactivés par défaut. Lorsqu’ils sont demandés, chaque mot aligné peut avoir son début et sa fin en millisecondes par rapport au début du clip. Le profil du concepteur laisse ces valeurs absentes lorsqu’un mot ne peut pas être aligné, plutôt que d’inventer un horodatage approximatif. La précision des horodatages est meilleure pour l’audio anglais. Conservez explicitement les horodatages manquants lors de la préparation d’un surlignage des mots, d’une forme d’onde interrogeable ou d’un alignement de sous-titres, et comparez le texte avec l’enregistrement avant de l’utiliser comme piste de sous-titres terminée.
Un prompt contextuel décrit le sujet de l’enregistrement. Il peut nommer un domaine, un scénario ou des détails précis déjà connus de l’application, et sa longueur maximale est de 6000 caractères. Commencez par une courte description adaptée à l’audio, par exemple une conversation d’assistance technique sur un appareil particulier. Le prompt fournit un contexte de reconnaissance ; ce n’est pas une demande de réécrire le message de la personne dans un autre document.
Une liste séparée de termes clés oriente la reconnaissance vers un vocabulaire spécifique. Le profil Sync accepte jusqu’à 100 termes et 8000 caractères dans l’ensemble de cette liste. Utilisez l’orthographe exacte des noms inhabituels, acronymes ou termes de produits et laissez hors de la liste les mots courants bien reconnus. Les listes de termes volumineuses ou inutiles peuvent provoquer des corrections excessives : concentrez donc la liste sur les mots importants dans l’enregistrement. La description du contexte et la liste de vocabulaire peuvent être utilisées ensemble.
La conversation antérieure peut aussi aider à interpréter une réponse courte. Fournissez les énoncés précédents dans l’ordre chronologique, du plus ancien au plus récent, tandis que l’audio actuel reste le tour à transcrire. Le budget de contexte documenté est de 500 tours ou 16 000 caractères au total. S’il dépasse ces plafonds ou le contexte disponible du modèle, les entrées les plus anciennes sont supprimées en premier. C’est utile lorsqu’une réponse brève contient un identifiant ou une référence dont le sens vient de la question précédente.
La sélection de langue oriente la reconnaissance vers une ou plusieurs langues attendues. L’interface Sync actuelle accepte 32 codes de langue et utilise l’anglais par défaut lorsqu’aucune sélection n’est fournie. Pour un audio alternant les langues, listez les langues attendues. Un prompt contextuel personnalisé remplace le prompt géré par défaut et prend le pas sur l’orientation séparée par codes de langue : nommez donc les langues attendues dans ce prompt lorsque le contexte de langue et de scénario sont tous deux nécessaires. Gardez la transcription dans les langues réellement parlées plutôt que de traiter la transcription comme une instruction de traduction.
Le modèle apparaît aussi dans d’autres parcours de transcription AssemblyAI, tandis que les exigences de clips courts et les champs de résultat du profil Sync appartiennent à cette interface particulière. Le parcours Dictation du concepteur ajoute une étape séparée de nettoyage du texte ; une transcription et un message réécrit sont des livrables différents. Préservez la parole reconnue si une étape ultérieure de révision ou de résumé produit une version nettoyée, afin que la formulation originale reste disponible pour comparaison.
Les livrables utiles comprennent un message vocal transcrit, un tour terminé pour un assistant, un court texte audio interrogeable ou une liste de mots horodatés pour une interface de révision. Vérifiez les mots décisifs à partir de l’enregistrement, préservez les éventuels alignements manquants et gardez le clip lié au texte renvoyé. Le résultat de reconnaissance fournit à l’étape applicative suivante une transcription étayée par sa source ; répondre à la demande ou modifier le message relève du parcours qui l’entoure.
Ailoot Ultra · Transcription audio POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proPremiers pas
Universal-3.5 Pro est le modèle de reconnaissance vocale d’AssemblyAI qui transforme un court clip audio en transcription complète en une réponse. Son profil Sync ajoute la confiance par mot, les horodatages facultatifs des mots, les indications de vocabulaire et le contexte de conversation antérieure pour la saisie vocale et les parcours push-to-talk.
- Entrées acceptées
- Audio
- Résultats
- Texte
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Transcription audio POST /v1/audio/transcriptions
- Types d’entrée
audio- Types de sortie
text
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites assemblyai/universal-3-5-pro | Par défaut— |
Champinput_audio | Typeobject | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, input_audio |
Paramètrematerial_types | Contrataudio |
Paramètrematerial_conditions | ContratL’exemple lit votre fichier PCM WAV réel et non vide, encode l’intégralité de ses octets en base64 et définit input_audio.format sur wav pour l’envoi. |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id exact provenant d’un enregistrement média existant vous appartenant
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
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 | Unité de facturation | Coût |
|---|---|---|---|
| ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | 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 |
| Configurationseconde d’audio en entrée | Barème tarifaire— | Unité de facturationpar seconde d’audio en entrée | Coût Entrée · seconde d’audio en entrée $0.00025 par seconde d’audio en entrée |
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 · Transcription audio
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual PCM WAV recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import base64, io, json, os, wave
from pathlib import Path
audio = Path(os.environ['AILOOT_AUDIO_FILE']).read_bytes()
if not (audio[:4] == b'RIFF' and audio[8:12] == b'WAVE'):
raise SystemExit('Supply your actual PCM WAV audio file')
with wave.open(io.BytesIO(audio), 'rb') as recording:
if recording.getcomptype() != 'NONE' or recording.getnframes() <= 0:
raise SystemExit('Supply a nonempty PCM WAV recording')
request = {'model': 'assemblyai/universal-3-5-pro', 'input_audio': {'data': base64.b64encode(audio).decode('ascii'), 'format': 'wav'}}
Path('request.json').write_text(json.dumps(request, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete original response, headers and actual X-Client-Request-ID.
# Read existing owned records for recovery; do not resubmit an uncertain operation.
Recevoir et enregistrer les résultats
Ailoot Ultra · Transcription audio
Corps complet de la réponse d’origine, statut et en-têtes transmis. Ce gestionnaire n’ajoute aucune structure JSON universelle, aucun champ texte ni aucune enveloppe de tâche.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.
Si la réponse d’origine doit être vérifiée
Conservez la valeur réelle de X-Client-Request-ID et la réponse complète. Consultez les ressources d’origine vous appartenant et leurs URL signées exactes de contenu ; ne soumettez jamais à nouveau une création incertaine.
Champs de la réponse
| Champ | Type |
|---|---|
Champtext (when present) | Type |
Champusage (when present) | Type |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionLe corps JSON ou l’identifiant canonique explicite du modèle n’est pas valide. | Étape suivanteConservez la réponse et corrigez le champ de requête indiqué. |
Réponse401 · authentication_error | ConditionLa clé API Ailoot n’est pas valide. | Étape suivanteUtilisez votre clé API Ailoot autorisée. |
Réponse403 · permission_error | ConditionLe groupe de la clé n’autorise pas cette méthode. | Étape suivanteConservez les détails de l’erreur renvoyés. |
Réponse404 · not_found_error | ConditionLa méthode sélectionnée ne dispose d’aucune route autorisée. | Étape suivanteConservez les détails de l’erreur renvoyés. |
Réponse422 · price_unavailable | ConditionLe tarif accepté ne permet pas d’obtenir la quantité d’entrée ou la borne requise. | Étape suivanteConservez la réponse ; utilisez la représentation d’entrée requise par le tarif accepté. |
Réponse503 · | ConditionLe stockage, la route, le tarif de la méthode ou la réservation requis ne sont pas disponibles. | Étape suivanteConservez la réponse d’origine complète. Une réservation incertaine n’autorise pas une nouvelle soumission. |
Réponse502 · server_error | ConditionLe résultat d’origine, l’utilisation ou le règlement nécessite une vérification. | Étape suivanteConservez l’identifiant réel de la requête et la réponse d’origine. Consultez l’enregistrement existant vous appartenant ; ne soumettez pas à nouveau la création. |
Alias
Alias du modèle
Ailoot Ultra assemblyai/universal-3-5-pro
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · AssemblyAI: Universal-3.5 Pro
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Quels champs la requête utilise-t-elle ?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio