AssemblyAI: Universal-3.5 Pro
Το Universal-3.5 Pro είναι το μοντέλο μετατροπής ομιλίας σε κείμενο της AssemblyAI για τη μετατροπή σύντομου ηχητικού αποσπάσματος σε ολοκληρωμένη απομαγνητοφώνηση με μία απάντηση. Το προφίλ Sync προσθέτει βαθμό εμπιστοσύνης ανά λέξη, προαιρετικές χρονικές σημάνσεις λέξεων, υποδείξεις λεξιλογίου και πλαίσιο προηγούμενης συνομιλίας για φωνητική είσοδο και ροές push-to-talk.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Universal-3.5 Pro είναι το μοντέλο αναγνώρισης ομιλίας της AssemblyAI για μετατροπή ηχογραφημένης ομιλίας σε κείμενο. Στο προφίλ Sync, ένα σύντομο ηχητικό απόσπασμα παράγει ολοκληρωμένη απομαγνητοφώνηση με μία απάντηση. Αυτό ταιριάζει σε φωνητικά μηνύματα, είσοδο push-to-talk και διακριτές παρεμβάσεις συνομιλίας όπου η εφαρμογή γνωρίζει ήδη πότε πρέπει να τελειώσει η εγγραφή.
Προετοιμάστε τον ήχο ως οριοθετημένο απόσπασμα. Οι απαιτήσεις Sync της AssemblyAI δέχονται διάρκεια από 80 χιλιοστά του δευτερολέπτου έως 120 δευτερόλεπτα, με μέγιστο μέγεθος αρχείου 40 MB. Οι υποστηριζόμενες μορφές είναι WAV ή ακατέργαστο PCM με πρόσημο, 16 bit και σειρά byte little-endian. Ο ήχος μπορεί να είναι μονοφωνικός ή στερεοφωνικός, με εσωτερική μίξη του στερεοφωνικού σε μονοφωνικό. Οι υποστηριζόμενοι ρυθμοί δειγματοληψίας είναι 8, 16, 22.05, 24, 32, 44.1 και 48 kHz. Μια κεφαλίδα WAV παρέχει τον ρυθμό δειγματοληψίας και τον αριθμό καναλιών· το ακατέργαστο PCM χρειάζεται αυτές τις τιμές χωριστά στη διαμόρφωση απομαγνητοφώνησης.
Καταγράψτε ολόκληρη την εκφώνηση και διατηρήστε ακέραια την αρχή και το τέλος της ομιλίας. Μια χρήσιμη πρωτότυπη εργασία είναι ένα σύντομο φωνητικό μήνυμα υποστήριξης προϊόντος που περιέχει όνομα προϊόντος, αναγνωριστικό παραγγελίας και αίτημα. Διατηρήστε το αρχικό απόσπασμα ώστε η απομαγνητοφώνηση να μπορεί να ελεγχθεί ως προς αυτές τις σημαντικές λεπτομέρειες. Για μεγαλύτερη εγγραφή, προετοιμάστε ροή κατάλληλη για απομαγνητοφώνηση μεγάλης διάρκειας αντί να αντιμετωπίζετε το όριο διάρκειας σύντομων αποσπασμάτων ως ισχυρισμό για τη συνολική ηχητική χωρητικότητα του μοντέλου.
Το αποτέλεσμα περιέχει ολόκληρη την απομαγνητοφώνηση, λίστα λέξεων με βαθμό εμπιστοσύνης ανά λέξη και συνολικό βαθμό εμπιστοσύνης από το μηδέν έως το ένα. Παρέχει επίσης τη διάρκεια του υποβληθέντος ήχου και αναγνωριστικό αιτήματος, επιτρέποντας να κρατάτε το κείμενο συνδεδεμένο με το αρχικό του απόσπασμα. Χρησιμοποιήστε τον βαθμό εμπιστοσύνης λέξεων για να εντοπίσετε αποσπάσματα που αξίζουν ακουστικό έλεγχο, ιδίως ονόματα, αριθμούς και λεξιλόγιο πεδίου που έχουν σημασία για την εφαρμογή.
Οι χρονικές σημάνσεις λέξεων είναι προαιρετικές και απενεργοποιημένες από προεπιλογή. Όταν ζητούνται, κάθε ευθυγραμμισμένη λέξη μπορεί να φέρει αρχή και τέλος σε χιλιοστά του δευτερολέπτου ως προς την αρχή του αποσπάσματος. Το προφίλ του δημιουργού αφήνει αυτές τις τιμές απούσες όταν μια λέξη δεν μπορεί να ευθυγραμμιστεί, αντί να επινοεί κατά προσέγγιση χρονισμό. Η ακρίβεια χρονικών σημάνσεων είναι καλύτερη για αγγλικό ήχο. Διατηρήστε ρητά τους χρονισμούς που λείπουν όταν προετοιμάζετε επισήμανση λέξεων, κυματομορφή με δυνατότητα αναζήτησης ή ευθυγράμμιση υποτίτλων και συγκρίνετε το κείμενο με την εγγραφή πριν το χρησιμοποιήσετε ως ολοκληρωμένο κανάλι υποτίτλων.
Μια προτροπή πλαισίου περιγράφει το θέμα της εγγραφής. Μπορεί να ονομάζει πεδίο, σενάριο ή συγκεκριμένες λεπτομέρειες που γνωρίζει ήδη η εφαρμογή και το μέγιστο μήκος της είναι 6000 χαρακτήρες. Ξεκινήστε με σύντομη περιγραφή που ταιριάζει στον ήχο, όπως συνομιλία τεχνικής υποστήριξης για συγκεκριμένη συσκευή. Η προτροπή παρέχει πλαίσιο αναγνώρισης· δεν είναι αίτημα να ξαναγραφτεί το μήνυμα του ομιλητή ως διαφορετικό έγγραφο.
Μια ξεχωριστή λίστα βασικών όρων κατευθύνει την αναγνώριση προς συγκεκριμένο λεξιλόγιο. Το προφίλ Sync δέχεται έως 100 όρους και 8000 χαρακτήρες συνολικά σε αυτή τη λίστα. Χρησιμοποιήστε ακριβή ορθογραφία για ασυνήθιστα ονόματα, ακρωνύμια ή όρους προϊόντων και αφήστε έξω από τη λίστα τις συνηθισμένες λέξεις που αναγνωρίζονται καλά. Μεγάλες ή περιττές λίστες όρων μπορούν να προκαλέσουν υπερδιορθώσεις, επομένως εστιάστε τη λίστα στις λέξεις που έχουν σημασία στην εγγραφή. Η περιγραφή πλαισίου και η λίστα λεξιλογίου μπορούν να χρησιμοποιούνται μαζί.
Η προηγούμενη συνομιλία μπορεί επίσης να βοηθά στην ερμηνεία σύντομης απάντησης. Δώστε τις προηγούμενες εκφωνήσεις με χρονολογική σειρά, από την παλαιότερη στη νεότερη, ενώ ο τρέχων ήχος παραμένει η παρέμβαση που απομαγνητοφωνείται. Το τεκμηριωμένο όριο πλαισίου είναι 500 παρεμβάσεις ή 16 000 χαρακτήρες συνολικά. Αν υπερβαίνει αυτά τα όρια ή το διαθέσιμο πλαίσιο μοντέλου, αφαιρούνται πρώτα οι παλαιότερες εγγραφές. Αυτό είναι χρήσιμο όταν μια σύντομη απάντηση περιέχει αναγνωριστικό ή αναφορά της οποίας το νόημα προέρχεται από το προηγούμενο ερώτημα.
Η επιλογή γλώσσας κατευθύνει την αναγνώριση προς μία ή περισσότερες αναμενόμενες γλώσσες. Η τρέχουσα διεπαφή Sync δέχεται 32 κωδικούς γλώσσας και έχει προεπιλογή τα αγγλικά όταν δεν παρέχεται επιλογή. Για ήχο με εναλλαγή γλωσσών, απαριθμήστε τις αναμενόμενες γλώσσες. Μια προσαρμοσμένη προτροπή πλαισίου αντικαθιστά τη διαχειριζόμενη προεπιλογή και υπερισχύει της ξεχωριστής καθοδήγησης κωδικών γλώσσας, επομένως ονομάστε τις αναμενόμενες γλώσσες μέσα σε αυτή την προτροπή όταν χρειάζονται τόσο γλωσσικό πλαίσιο όσο και πλαίσιο σεναρίου. Κρατήστε την απομαγνητοφώνηση στις γλώσσες που πραγματικά ομιλούνται αντί να αντιμετωπίζετε την απομαγνητοφώνηση ως οδηγία μετάφρασης.
Το μοντέλο εμφανίζεται επίσης σε άλλες ροές απομαγνητοφώνησης της AssemblyAI, ενώ οι απαιτήσεις σύντομων αποσπασμάτων και τα πεδία αποτελέσματος του προφίλ Sync ανήκουν σε αυτή τη συγκεκριμένη διεπαφή. Η ροή Dictation του δημιουργού προσθέτει ξεχωριστό στάδιο καθαρισμού κειμένου· μια απομαγνητοφώνηση και ένα ξαναγραμμένο μήνυμα είναι διαφορετικά παραδοτέα. Διατηρήστε την αναγνωρισμένη ομιλία αν ένα μεταγενέστερο βήμα επεξεργασίας ή σύνοψης παράγει καθαρισμένη εκδοχή, ώστε η αρχική διατύπωση να παραμένει διαθέσιμη για σύγκριση.
Χρήσιμα παραδοτέα περιλαμβάνουν απομαγνητοφωνημένο φωνητικό μήνυμα, ολοκληρωμένο μήνυμα για έναν βοηθό, σύντομο κείμενο απομαγνητοφώνησης με δυνατότητα αναζήτησης ή χρονοσημασμένη λίστα λέξεων για διεπαφή ελέγχου. Ελέγξτε τις καθοριστικές λέξεις ως προς την εγγραφή, διατηρήστε τυχόν ευθυγραμμίσεις που λείπουν και κρατήστε το απόσπασμα συνδεδεμένο με το επιστρεφόμενο κείμενο. Το αποτέλεσμα αναγνώρισης δίνει στο επόμενο βήμα της εφαρμογής μια απομαγνητοφώνηση που υποστηρίζεται από την πηγή· η απάντηση στο αίτημα ή η επεξεργασία του μηνύματος ανήκει στην περιβάλλουσα ροή εργασίας.
Ailoot Ultra · Απομαγνητοφώνηση POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proΕισαγωγή
Το Universal-3.5 Pro είναι το μοντέλο μετατροπής ομιλίας σε κείμενο της AssemblyAI για τη μετατροπή σύντομου ηχητικού αποσπάσματος σε ολοκληρωμένη απομαγνητοφώνηση με μία απάντηση. Το προφίλ Sync προσθέτει βαθμό εμπιστοσύνης ανά λέξη, προαιρετικές χρονικές σημάνσεις λέξεων, υποδείξεις λεξιλογίου και πλαίσιο προηγούμενης συνομιλίας για φωνητική είσοδο και ροές push-to-talk.
- Αποδεκτές είσοδοι
- Ήχος
- Αποτελέσματα
- Κείμενο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Απομαγνητοφώνηση POST /v1/audio/transcriptions
- Είσοδος
audio- Έξοδος
text
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια assemblyai/universal-3-5-pro | Προεπιλογή— |
Πεδίοinput_audio | Τύποςobject | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, input_audio |
Παράμετροςmaterial_types | Σύμβασηaudio |
Παράμετροςmaterial_conditions | ΣύμβασηΤο παράδειγμα διαβάζει το πραγματικό, μη κενό αρχείο PCM WAV σας, κωδικοποιεί όλα τα byte του αρχείου σε base64 και στέλνει το input_audio.format ως wav. |
Κύκλος ζωής: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · ακριβές task_id από υπάρχουσα εγγραφή πολυμέσων που σας ανήκουν
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Μονάδα τιμολόγησης | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Μονάδα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου — / 1K token Έξοδος · Token εξόδου — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| Διαμόρφωσηδευτερόλεπτο ήχου εισόδου | Πίνακας χρεώσεων— | Μονάδα τιμολόγησηςανά δευτερόλεπτο ήχου εισόδου | Χρέωση Είσοδος · δευτερόλεπτο ήχου εισόδου $0.00025 ανά δευτερόλεπτο ήχου εισόδου |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Απομαγνητοφώνηση
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.
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Απομαγνητοφώνηση
Ολόκληρο το αρχικό σώμα απόκρισης, η κατάσταση και οι προωθημένες κεφαλίδες. Αυτός ο χειριστής δεν προσθέτει καθολική δομή JSON, πεδίο κειμένου ή περίβλημα εργασίας.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, κάθε πραγματικό αποτέλεσμα εξόδου, τα αρχικά αναγνωριστικά που επιστράφηκαν και όλα τα πεδία χρήσης. Ανακτήστε την αρχική λειτουργία χωρίς να υποβάλετε ξανά αίτημα δημιουργίας.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το πραγματικό X-Client-Request-ID και ολόκληρη την απόκριση. Διαβάστε τα αρχικά αρχεία πολυμέσων που σας ανήκουν και τα ακριβή υπογεγραμμένα URL περιεχομένου τους· μην επανυποβάλετε ποτέ αίτημα δημιουργίας με αβέβαιο αποτέλεσμα.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοtext (when present) | Τύπος |
Πεδίοusage (when present) | Τύπος |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΤο σώμα JSON ή το ρητό κανονικό ID μοντέλου δεν είναι έγκυρο. | Επόμενο βήμαΔιατηρήστε την απόκριση και διορθώστε το υποδεικνυόμενο πεδίο του αιτήματος. |
Απάντηση401 · authentication_error | ΣυνθήκηΤο κλειδί API του Ailoot δεν είναι έγκυρο. | Επόμενο βήμαΧρησιμοποιήστε το εξουσιοδοτημένο κλειδί API του Ailoot σας. |
Απάντηση403 · permission_error | ΣυνθήκηΗ ομάδα του κλειδιού δεν επιτρέπει πρόσβαση σε αυτή τη μέθοδο. | Επόμενο βήμαΔιατηρήστε τις λεπτομέρειες σφάλματος που επιστρέφονται. |
Απάντηση404 · not_found_error | ΣυνθήκηΗ επιλεγμένη μέθοδος δεν έχει διαδρομή με άδεια πρόσβασης. | Επόμενο βήμαΔιατηρήστε τις λεπτομέρειες σφάλματος που επιστρέφονται. |
Απάντηση422 · price_unavailable | ΣυνθήκηΤο αποδεκτό τιμολόγιο δεν μπορεί να λάβει την απαιτούμενη ποσότητα εισόδου ή το όριό της. | Επόμενο βήμαΔιατηρήστε την απόκριση· χρησιμοποιήστε την αναπαράσταση εισόδου που απαιτεί το αποδεκτό τιμολόγιο. |
Απάντηση503 · | ΣυνθήκηΟ απαιτούμενος χώρος αποθήκευσης, η διαδρομή, η τιμή μεθόδου ή η δέσμευση ποσού δεν είναι διαθέσιμα. | Επόμενο βήμαΔιατηρήστε ολόκληρη την αρχική απόκριση. Μια αβέβαιη δέσμευση ποσού δεν αποτελεί άδεια επανυποβολής. |
Απάντηση502 · server_error | ΣυνθήκηΤο αρχικό αποτέλεσμα, η χρήση ή η εκκαθάριση απαιτεί έλεγχο. | Επόμενο βήμαΔιατηρήστε το πραγματικό ID αιτήματος και την αρχική απόκριση. Διαβάστε την υπάρχουσα εγγραφή που σας ανήκει· μην επανυποβάλετε αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra assemblyai/universal-3-5-pro
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · AssemblyAI: Universal-3.5 Pro
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio