ElevenLabs: Scribe v2
ElevenLabs Scribe v2 transcribe audio grabado en más de 90 idiomas, con tiempos por palabra, diarización opcional de hablantes y etiquetas de eventos no verbales. Está diseñado para grabaciones largas, subtítulos y transcripciones editables, con términos clave contextuales y opciones de transcripción literal o depurada.
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.
ElevenLabs Scribe v2 es el modelo de reconocimiento de voz por lotes para audio grabado, transcripción y subtitulado. Amplía Scribe v1 con un mejor tratamiento de grabaciones largas, pausas, cambios de tono y silencios prolongados. El resultado es el habla escrita con información temporal y anotaciones opcionales de hablantes y eventos de audio. Scribe v2 Realtime es una edición separada de transcripción en directo; el propósito de este modelo es procesar grabaciones completas.
El fabricante documenta reconocimiento en más de 90 idiomas y detección automática del idioma, incluidas grabaciones que alternan entre idiomas. Una indicación del idioma conocido puede ayudar al modelo a interpretar el audio. Prepara una grabación clara, conserva el idioma y los nombres originales y evita la saturación grave o el procesamiento innecesario que elimine detalles del habla. Entre las entradas habituales documentadas figuran WAV, MP3, FLAC, M4A, AAC, OGG, Opus y WebM. Elige una representación de entrada admitida por la implementación de transcripción y conserva la grabación fuente para revisarla.
La respuesta estándar contiene el texto reconocido, información sobre el idioma detectado y una secuencia de palabras con tiempos. Los registros de palabras pueden incluir tiempos de inicio y fin, identificadores de hablantes y una log-probabilidad de reconocimiento. Esto hace útil el resultado para subtítulos, entrevistas consultables o un editor que vuelva al sonido pertinente. Conserva el resultado temporal junto al audio fuente. Para un pódcast, por ejemplo, el resultado puede ser una transcripción editable y un registro alineado por palabras que permita localizar correcciones antes de organizar los subtítulos.
La diarización etiqueta quién habla y cuándo en audio con varios hablantes; el fabricante documenta hasta 32 hablantes. Actívala cuando los turnos sean importantes y proporciona un número razonable de hablantes si se conoce esa información. Distingue una etiqueta de hablante detectada del nombre verificado de una persona. Para una entrevista o reunión, revisa los cambios de turno contra la grabación, especialmente cuando las voces se superpongan o suenen similares. Una etiqueta ayuda a organizar la transcripción; no establece por sí sola la identidad del hablante.
Una grabación con un hablante por canal tiene una estructura distinta de varias voces mezcladas en un canal. La interfaz del productor puede procesar hasta cinco canales de forma independiente y devolver transcripciones separadas o una transcripción combinada ordenada por tiempo, con índices de canal. Conserva esa disposición de canales cuando sea significativa. Mezclar una grabación de llamada separada en canales antes de transcribirla puede descartar una fuente útil de información sobre los hablantes. Mantén la atribución por canal separada de la diarización inferida de audio mezclado. La respuesta combinada de canales requiere marcas de tiempo y no puede incluir detección ni ocultación de entidades.
La indicación de términos clave orienta el reconocimiento de nombres, términos de producto y vocabulario especializado mediante el contexto. La documentación actual por lotes permite hasta 1,000 términos, cada uno con menos de 50 caracteres y un máximo de cinco palabras. Proporciona las grafías pertinentes en lugar de un catálogo amplio sin relación. Para una entrevista técnica, facilita los nombres de productos y las abreviaturas que probablemente aparezcan y después inspecciónalos en sus marcas de tiempo del resultado. Los términos clave sesgan el reconocimiento; no son instrucciones para insertar un término cuando la grabación no lo respalda.
Elige el propósito de la transcripción antes de depurarla. Un registro literal conserva las palabras pronunciadas, mientras que la opción documentada no-verbatim elimina muletillas, comienzos fallidos y disfluencias para ofrecer un resultado más legible. El etiquetado dinámico de audio puede identificar eventos no verbales como risas o pasos. Una transcripción pulida puede resultar útil para subtítulos o lectura, pero no debe sustituir silenciosamente al registro original cuando las repeticiones, correcciones o sonidos no verbales sean importantes para la tarea.
El fabricante también documenta detección de entidades y edición experimental de transcripciones. En la interfaz del productor, la edición de transcripciones no puede combinarse con detección de entidades, ocultación de entidades ni transcripción multicanal. Las entidades detectadas proporcionan posiciones estructuradas de información seleccionada en la transcripción. La ocultación opcional de entidades enmascara el texto detectado con etiquetas de sustitución; depende de la detección de entidades y la lista de entidades no se devuelve cuando se activa la ocultación. La ocultación se realiza durante la transcripción, utilizando un marcador genérico de sustitución, una etiqueta de categoría o una etiqueta de categoría numerada. La ocultación automática puede pasar por alto contenido sensible, así que inspecciona la transcripción anonimizada antes de compartirla. Una edición en lenguaje natural devuelve texto editado junto al resultado original, manteniendo disponibles el registro temporal y el de hablantes originales. Conserva esos artefactos separados: una grafía corregida o una frase reformateada pueden necesitar una nueva comprobación antes de alinearse con el audio o utilizarse en una extracción posterior. Estas funciones procesan la transcripción; no demuestran que todos los detalles importantes se hayan reconocido correctamente.
Para una transcripción terminada, revisa nombres, números, negaciones y cambios de hablante volviendo al audio correspondiente. Presta atención a las secciones de bajo volumen, las superposiciones y los cambios de idioma, en lugar de valorar la calidad solo por la fluidez del texto. Conserva las expresiones inciertas para corregirlas, en lugar de completar un pasaje inaudible con una frase plausible. El resultado útil es un registro textual comprobado con la información temporal y de hablantes necesaria para su uso previsto; después, una transcripción puede convertirse en entrada de un paso separado de resumen, traducción o análisis.
Ailoot Ultra · Transcripción POST /v1/audio/transcriptions elevenlabs/scribe-v2
elevenlabs/scribe-v2Primeros pasos
ElevenLabs Scribe v2 transcribe audio grabado en más de 90 idiomas, con tiempos por palabra, diarización opcional de hablantes y etiquetas de eventos no verbales. Está diseñado para grabaciones largas, subtítulos y transcripciones editables, con términos clave contextuales y opciones de transcripción literal o depurada.
- Entradas aceptadas
- Audio
- Resultados
- Texto
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Transcripción POST /v1/audio/transcriptions
- Tipos de entrada
audio- Tipos de salida
text
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites elevenlabs/scribe-v2 | Predeterminado— |
Campoinput_audio | Tipoobject | RequisitoObligatorio | Valores y límites | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, input_audio |
Parámetromaterial_types | Contratoaudio |
Parámetromaterial_conditions | ContratoEl ejemplo lee tu archivo PCM WAV real y no vacío, codifica todos los bytes del archivo en base64 y envía input_audio.format con el valor wav. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id exacto de un registro existente de medios bajo tu titularidad
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planes
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (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 | Unidad de facturación | Cargo |
|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | 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ónsegundo de audio de entrada | Tabla de tarifas— | Unidad de facturaciónpor segundo de audio de entrada | Cargo Entrada · segundo de audio de entrada $0.0001222222222222 por segundo de audio de entrada |
Ailoot reserva un importe 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 · Transcripción
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.
Recibir y guardar resultados
Ailoot Ultra · Transcripción
Cuerpo original completo de la respuesta, estado y cabeceras reenviadas. Este manejador no añade una estructura JSON universal, un campo de texto ni un contenedor de tarea.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.
Si es necesario revisar la respuesta original
Conserva el X-Client-Request-ID real y la respuesta completa. Consulta los recursos originales bajo tu titularidad y sus URL firmadas exactas de contenido; no vuelvas a enviar nunca una creación incierta.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campotext (when present) | Tipo |
Campousage (when present) | Tipo |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónEl cuerpo JSON o el ID canónico explícito del modelo no es válido. | Siguiente pasoConserva la respuesta y corrige el campo indicado de la solicitud. |
Respuesta401 · authentication_error | CondiciónLa clave API de Ailoot no es válida. | Siguiente pasoUsa tu clave API autorizada de Ailoot. |
Respuesta403 · permission_error | CondiciónEl grupo de la clave no tiene acceso a este método. | Siguiente pasoConserva los detalles del error devueltos. |
Respuesta404 · not_found_error | CondiciónEl método seleccionado no tiene ninguna ruta admitida. | Siguiente pasoConserva los detalles del error devueltos. |
Respuesta422 · price_unavailable | CondiciónLa tarifa aceptada no puede obtener la cantidad de entrada o el límite que necesita. | Siguiente pasoConserva la respuesta; utiliza la representación de entrada exigida por la tarifa aceptada. |
Respuesta503 · | CondiciónEl almacenamiento, la ruta, el precio del método o la reserva necesarios no están disponibles. | Siguiente pasoConserva la respuesta original completa. Una reserva incierta no autoriza un reenvío. |
Respuesta502 · server_error | CondiciónEs necesario comprobar el resultado original, el uso o la liquidación. | Siguiente pasoConserva el ID real de solicitud y la respuesta original. Consulta el registro existente bajo tu titularidad; no vuelvas a enviar la solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra elevenlabs/scribe-v2
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · ElevenLabs: Scribe v2
- ¿Qué entradas y resultados están disponibles?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:audio→text- ¿Qué campos utiliza la solicitud?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:model,input_audio