ElevenLabs: Scribe v2
ElevenLabs Scribe v2 transcrit les enregistrements audio dans plus de 90 langues, avec un horodatage au niveau des mots, une diarisation facultative des locuteurs et des balises d’événements non vocaux. Il est conçu pour les longs enregistrements, le sous-titrage et les transcriptions modifiables, avec des termes clés contextuels et un choix entre la transcription mot à mot et une version épurée.
À 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.
ElevenLabs Scribe v2 est le modèle de reconnaissance vocale par lots pour les enregistrements audio, la transcription, le sous-titrage et le sous-titrage pour personnes sourdes et malentendantes. Il s’appuie sur Scribe v1 en améliorant le traitement des longs enregistrements, des pauses, des changements de ton et des silences prolongés. Il produit les paroles écrites avec des renseignements d’horodatage et des annotations facultatives des locuteurs et des événements audio. Scribe v2 Realtime est une édition distincte de transcription en direct; ce modèle sert à traiter des enregistrements complets.
Le fabricant documente la reconnaissance dans plus de 90 langues et la détection automatique de la langue, y compris pour les enregistrements où l’on alterne entre plusieurs langues. Une indication de langue connue peut aider le modèle à interpréter l’audio. Préparez un enregistrement clair, conservez la langue et les noms d’origine, et évitez l’écrêtage important ou les traitements inutiles qui éliminent des détails de la parole. Les formats d’entrée courants documentés comprennent WAV, MP3, FLAC, M4A, AAC, OGG, Opus et WebM. Choisissez une représentation d’entrée prise en charge par l’implémentation de transcription et conservez l’enregistrement source pour la révision.
La réponse standard contient le texte reconnu, les renseignements sur la langue détectée et une séquence de mots horodatés. Les enregistrements de mots peuvent comprendre les heures de début et de fin, les identifiants de locuteurs et une log-probabilité de reconnaissance. Ces données rendent le résultat utile pour les sous-titres, les entrevues consultables par recherche ou un éditeur qui permet de revenir au son pertinent. Conservez le résultat horodaté avec l’audio source. Pour un balado, par exemple, le livrable peut être une transcription modifiable et un relevé aligné sur les mots qui aide à retrouver les corrections avant d’organiser les sous-titres.
La diarisation des locuteurs indique qui parle et à quel moment dans un audio comportant plusieurs locuteurs; le fabricant documente jusqu’à 32 locuteurs. Activez-la lorsque les tours de parole sont importants et fournissez un nombre raisonnable de locuteurs si vous le connaissez. Distinguez une étiquette de locuteur détectée du nom vérifié d’une personne. Pour une entrevue ou une réunion, vérifiez les changements de tour dans l’enregistrement, surtout lorsque des voix se chevauchent ou se ressemblent. Une étiquette aide à organiser la transcription; elle n’établit pas à elle seule l’identité du locuteur.
Un enregistrement avec un locuteur par canal présente une structure différente de plusieurs voix mixées sur un même canal. L’interface du fournisseur peut traiter jusqu’à cinq canaux indépendamment et retourner des transcriptions séparées ou une transcription combinée classée dans l’ordre temporel, avec les indices des canaux. Conservez cette disposition des canaux lorsqu’elle est pertinente. La fusion préalable des canaux d’un enregistrement d’appel peut éliminer une source utile de renseignements sur les locuteurs. Distinguez l’attribution fondée sur les canaux de la diarisation inférée à partir d’un audio mixé. La réponse qui combine les canaux exige des horodatages et ne peut pas inclure la détection ni le caviardage d’entités.
La consigne par termes clés guide, à l’aide du contexte, la reconnaissance des noms, des termes de produits et du vocabulaire spécialisé. La documentation actuelle du traitement par lots autorise jusqu’à 1 000 termes, chacun devant compter moins de 50 caractères et au plus cinq mots. Fournissez les graphies pertinentes plutôt qu’un vaste catalogue sans rapport avec la tâche. Pour une entrevue technique, fournissez les noms de produits et les abréviations susceptibles d’apparaître, puis vérifiez-les à leurs repères temporels dans le résultat. Les termes clés orientent la reconnaissance; ils ne demandent pas d’insérer un terme que l’enregistrement ne justifie pas.
Choisissez l’usage de la transcription avant d’appliquer une épuration. Une transcription mot à mot conserve la formulation orale, tandis que l’option documentée de transcription non littérale élimine les mots de remplissage, les faux départs et les disfluences pour rendre le résultat plus lisible. Le balisage audio dynamique peut identifier des événements non vocaux comme les rires ou les pas. Une transcription soignée peut être utile pour les sous-titres ou la lecture, mais elle ne doit pas remplacer discrètement le relevé brut lorsque les répétitions, les corrections ou les sons non vocaux sont importants pour la tâche.
Le fabricant documente également la détection d’entités et la modification expérimentale des transcriptions. Dans l’interface du fournisseur, la modification des transcriptions ne peut pas être combinée à la détection d’entités, au caviardage d’entités ni à la transcription multicanal. Les entités détectées fournissent des positions structurées pour certaines informations de la transcription. Le caviardage facultatif des entités masque le texte détecté avec des étiquettes de remplacement; il dépend de la détection d’entités, et la liste des entités n’est pas retournée lorsque le caviardage est activé. Le caviardage a lieu pendant la transcription, à l’aide d’un marqueur de remplacement générique, d’une étiquette de catégorie ou d’une étiquette de catégorie numérotée. Le caviardage automatique peut manquer du contenu sensible; vérifiez donc la transcription caviardée avant de la partager. Une modification formulée en langage naturel retourne un texte modifié avec le résultat original, en laissant disponibles l’horodatage et le relevé des locuteurs d’origine. Gardez ces livrables distincts : une graphie corrigée ou une phrase remise en forme peut nécessiter une nouvelle vérification avant d’être alignée sur l’audio ou utilisée dans une extraction en aval. Ces fonctions traitent la transcription; elles n’établissent pas que chaque détail important a été reconnu correctement.
Pour terminer une transcription, vérifiez les noms, les nombres, les négations et les changements de locuteur en revenant aux passages audio correspondants. Portez attention aux segments de faible volume, aux chevauchements et aux alternances de langue au lieu de juger la qualité uniquement sur la fluidité du texte. Conservez les formulations incertaines pour les corriger plutôt que de compléter un passage inaudible avec une phrase plausible. Le résultat utile est un relevé textuel vérifié, avec les renseignements d’horodatage et de locuteurs nécessaires à son usage prévu; une transcription peut ensuite servir d’entrée à une étape distincte de résumé, de traduction ou d’analyse.
Ailoot Ultra · Transcription audio POST /v1/audio/transcriptions elevenlabs/scribe-v2
elevenlabs/scribe-v2Pour commencer
ElevenLabs Scribe v2 transcrit les enregistrements audio dans plus de 90 langues, avec un horodatage au niveau des mots, une diarisation facultative des locuteurs et des balises d’événements non vocaux. Il est conçu pour les longs enregistrements, le sous-titrage et les transcriptions modifiables, avec des termes clés contextuels et un choix entre la transcription mot à mot et une version épurée.
- Entrées acceptées
- Audio
- Résultats
- Texte
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Transcription audio POST /v1/audio/transcriptions
- Entrée
audio- Sortie
text
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites elevenlabs/scribe-v2 | 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 tous les octets du fichier en base64 et envoie input_audio.format avec la valeur wav. |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id exact d’un enregistrement média existant appartenant à votre compte
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 des jetons | Barème tarifaireTarif de base | Unité de facturation— | Coût Entrée · Jetons en entrée — / 1K jetons Sortie · Jetons en sortie — / 1K jetons Entrée · Lecture du cache — / 1K jetons Entrée · Écriture dans le cache — / 1K jetons Entrée · Écriture dans le cache, 1 h — / 1K jetons |
| 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.0001222222222222 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': 'elevenlabs/scribe-v2', '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 de réponse d’origine complet, état et en-têtes transmis. Ce gestionnaire n’ajoute aucune structure JSON universelle, aucun champ de texte et 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 le X-Client-Request-ID réel et la réponse complète. Consultez les ressources d’origine appartenant à votre compte et leurs URL exactes de contenu signées; ne soumettez jamais de 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 est invalide. | Étape suivanteConservez la réponse et corrigez le champ de demande indiqué. |
Réponse401 · authentication_error | ConditionLa clé API Ailoot est invalide. | É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 d’erreur retournés. |
Réponse404 · not_found_error | ConditionLa méthode sélectionnée ne possède aucune route autorisée. | Étape suivanteConservez les détails d’erreur retournés. |
Réponse422 · price_unavailable | ConditionLe tarif accepté ne peut pas obtenir la quantité d’entrée ou la borne dont il a besoin. | Étape suivanteConservez la réponse; utilisez la représentation d’entrée exigée par le tarif accepté. |
Réponse503 · | ConditionLe stockage, la route, le tarif de la méthode ou la réservation requis n’est pas disponible. | É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 doit être vérifié. | Étape suivanteConservez l’identifiant réel de demande et la réponse d’origine. Consultez l’enregistrement existant appartenant à votre compte; ne soumettez pas de nouveau la demande de création. |
Alias
Alias du modèle
Ailoot Ultra elevenlabs/scribe-v2
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · ElevenLabs: Scribe v2
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:audio→text- Quels champs la requête utilise-t-elle ?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:model,input_audio