OpenAI: Whisper 1
Whisper 1 transcribe un archivo de audio completo en texto, con reconocimiento multilingüe y marcas de tiempo de palabras o segmentos. El productor admite formatos de subtítulos y un flujo separado de traducción al inglés; la transcripción conserva el idioma de la grabación.
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.
Whisper 1 es el modelo API de reconocimiento de voz de uso general de OpenAI, documentado como basado en el modelo Whisper V2 de código abierto. Acepta un archivo de audio y devuelve texto. El fabricante describe reconocimiento multilingüe, identificación de idioma y una tarea separada de traducción de voz. La transcripción conserva el idioma hablado; la interfaz separada de traducción del productor devuelve texto en inglés.
Una aplicación útil es preparar una entrevista, nota de voz o conversación grabada para búsqueda y edición posteriores. Proporciona la grabación terminada y, cuando se conozca, su idioma de entrada. OpenAI documenta 98 idiomas compatibles y señala que la precisión del reconocimiento varía según el idioma. La indicación de un solo idioma utiliza un código ISO 639-1; los campos más nuevos de varios idiomas y palabras clave de otros modelos de transcripción son controles separados.
El flujo de transcripción de archivos del productor acepta archivos de hasta 25 MB en formato MP3, MP4, MPEG, MPGA, M4A, WAV o WebM. Para una grabación más grande, utiliza un formato comprimido o divídela en fragmentos dentro del límite. Conserva los límites de frases y el orden de fragmentos para que la transcripción ensamblada siga conectada con la grabación original. Un contenedor de video aporta su audio para esta tarea, en lugar de ser una entrada de descripción visual.
Un prompt puede proporcionar nombres, siglas o vocabulario específico de la grabación y contexto de un segmento anterior. El límite de prompt de Whisper es de 224 tokens y el prompt debe coincidir con el idioma del audio. El fabricante afirma que Whisper no sigue instrucciones como un modelo textual de uso general. Utiliza el prompt como contexto pertinente de transcripción y después comprueba las grafías importantes frente a la grabación, en lugar de tratar una lista terminológica como palabras que el hablante necesariamente haya dicho.
El productor documenta formatos de transcripción JSON, texto sin formato, SRT, VTT y JSON detallado. Las marcas de tiempo de palabras y segmentos requieren JSON detallado; pueden solicitarse una o ambas granularidades. La referencia API señala que los tiempos de segmento no añaden latencia extra, mientras que los tiempos de palabra requieren procesamiento adicional. Estas salidas permiten subtitulado y localización de pasajes durante la edición; las anotaciones de diarización de hablantes corresponden a un modelo especializado diferente.
Whisper 1 no admite streaming de transcripción de archivos. Su referencia también documenta una temperatura de muestreo entre cero y uno; con cero, el modelo puede aumentar automáticamente la temperatura cuando lo requieran sus umbrales de decodificación. Esto describe los controles de procesamiento del productor, en lugar de prometer que todas las grabaciones produzcan una transcripción idéntica o perfectamente precisa.
Define el artefacto final: una transcripción para búsqueda, un archivo de subtítulos o texto con tiempos de palabras o segmentos. Conserva la grabación original, el orden de fragmentos y las referencias temporales pertinentes de origen junto con el resultado. Un paso posterior de edición textual puede corregir una errata o preparar un resumen, pero compara los cambios con el audio para conservar el significado del hablante. El texto reconocido se convierte en evidencia para la siguiente tarea, en lugar de una respuesta generada a la pregunta hablada.
Ailoot Ultra · Reconocimiento de voz POST /v1/audio/transcriptions openai/whisper-1
openai/whisper-1Inicio
Whisper 1 transcribe un archivo de audio completo en texto, con reconocimiento multilingüe y marcas de tiempo de palabras o segmentos. El productor admite formatos de subtítulos y un flujo separado de traducción al inglés; la transcripción conserva el idioma de la grabación.
- Entradas aceptadas
- Audio
- Resultados
- transcription
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Reconocimiento de voz POST /v1/audio/transcriptions
- Entrada
audio- Salida
transcription- Formato de salida
- json
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites openai/whisper-1 | Predeterminado— |
Campofile | Tipofile | RequisitoObligatorio | Valores y límites Tipo de contenido: multipart/form-data | Predeterminado— |
Camporesponse_format | Tipostring | RequisitoOpcional | Valores y límites json | Predeterminado— |
Campoinput_audio.data | Tipobase64_string | RequisitoObligatorio | Valores y límites Se aplica cuando: Entrada JSON de WhisperOR | Predeterminado— |
Campoinput_audio.format | Tipostring | RequisitoObligatorio | Valores y límites wav, mp3, flac, ogg, m4a, webm Se aplica cuando: Entrada JSON de WhisperOR | Predeterminado— |
Combinaciones de materiales de entrada
· Obligatorio: model, file
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontours | Contrato{"content_types":["application/json","multipart/form-data"],"required_json":["model","input_audio.data","input_audio.format"],"required_multipart":["model","file"],"file_formats":["wav","mp3","flac","ogg","m4a","webm"],"response_format_optional":["json"]}, {"content_types":["multipart/form-data"],"required":["model","file"],"file_formats":["mp3"],"response_format_option":false} |
Parámetromax_bytes | Contrato26214400 |
Parámetromaterial_types | Contratoaudio |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · El task_id real devuelto o el registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Usa una grabación real y el formato correspondiente.
Conserva la transcripción completa, los segmentos, los ID de hablantes y los tiempos.
Tarifas
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste 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.0002 por segundo de audio de entrada |
Detalles de la tarifa de referencia
Las tablas de referencia del modelo no cambian la selección del método, las cotizaciones ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
OpenAI: Whisper 1
Precios por configuración
| Configuración | Condiciones de facturación | Cargo |
|---|---|---|
| ConfiguraciónOpenAI: Whisper 1 · Configuración predeterminada | Condiciones de facturaciónConfiguración predeterminada | Cargo Entrada · Segundos de audio de entrada USD 0.0002 por segundo de audio de entrada |
Ailoot reserva un monto 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 · Reconocimiento de voz
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual MP3 recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import os
from pathlib import Path
p=Path(os.environ["AILOOT_AUDIO_FILE"])
if not p.is_file() or p.suffix.lower()!=".mp3":raise SystemExit("Choose an existing MP3 recording")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--form-string model=openai/whisper-1 -F "file=@$AILOOT_AUDIO_FILE" \
-D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("result.json").read_text())))
PY_RESULT
Recibir y guardar resultados
Ailoot Ultra · Reconocimiento de voz
json
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Otras consultas de contenido
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
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva el JSON completo, no solo el texto; conserva cada segmento, hablante y marca de tiempo disponible, así como la identidad real de tarea y recurso.
Si es necesario revisar la respuesta original
Conserva el operation_id/X-Client-Request-ID original para la conciliación sin volver a enviar la solicitud; no hay una ruta específica para consultar el estado del audio.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campotext | Tipostring |
Camposegments[] | Tipoobject |
Campotask_id | Tipostring |
Campoasset_url | Tipostring |
Campousage | Tipoobject |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra openai/whisper-1
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · OpenAI: Whisper 1
- ¿Qué entradas y resultados están disponibles?
POST /v1/audio/transcriptions·openai/whisper-1:audio→transcription- ¿Qué campos utiliza la solicitud?
POST /v1/audio/transcriptions·openai/whisper-1:model,file,response_format