Transcribe 1 es el modelo general de voz a texto de Fish Audio para grabaciones cortas. Acepta un archivo de audio y devuelve las palabras reconocidas como texto, junto con la duración de la grabación, segmentos temporizados opcionales e información del idioma cuando se conoce. Este modelo resulta útil para una nota de voz corta, una instrucción hablada, un fragmento de una grabación o un clip de audio que necesite una representación legible en texto.
Un flujo ilustrativo de notas de voz conserva la grabación junto a su transcripción completa y un identificador del clip original. Un paso posterior de la aplicación puede buscar en ese texto, organizar la nota o elaborar un resumen conservando la fuente hablada. Para una orden, la transcripción proporciona a la aplicación las palabras reconocidas; cualquier acción es un paso independiente de interpretación y ejecución. Para un fragmento de entrevista, registra la posición del clip en el audio completo para poder comprobar una cita en el lugar correcto.
El productor acepta WAV, MP3, AAC, incluidos M4A/MP4, FLAC y Ogg con Opus o Vorbis. Las grabaciones del navegador en WebM deben convertirse a Ogg/Opus, MP3 o WAV para este modelo; Pro documenta compatibilidad nativa con contenedores adicionales. Proporciona un archivo de audio por petición. El límite documentado por petición del modelo base es de hasta 50 MiB, manteniendo los archivos MP3 y Opus por debajo de 25 MiB. El tamaño del archivo y la duración de la grabación son consideraciones distintas: un archivo comprimido puede ajustarse al límite de subida y, aun así, tardar demasiado en procesarse.
Transcribe 1 está diseñado para grabaciones cortas. El productor recomienda Pro para audio de más de unos pocos minutos; una petición larga al modelo base puede fallar si supera el límite de tiempo de procesamiento. Al preparar una fuente más larga para transcribir clips cortos, conserva el desplazamiento inicial de cada clip y confirma que la transcripción devuelta cubra el clip completo antes de combinar los resultados. Suma el desplazamiento original a los tiempos locales de los segmentos para mantener la navegación vinculada a la grabación completa. Las indicaciones del modelo base no deben interpretarse como el límite independiente de 60 minutos de Pro.
La respuesta del productor incluye texto, duración y segmentos. La duración se expresa en segundos y la transcripción completa legible debe conservarse como redacción principal del clip. Las marcas de tiempo son opcionales: ignore_timestamps tiene true como valor predeterminado en la API del productor, mientras que false solicita segmentos por palabra con texto y tiempos de inicio y fin en segundos. Solicitar alineación añade tiempo de procesamiento. Un array segments vacío puede reflejar que se ha omitido la temporización, que no hay habla o que la alineación no está disponible temporalmente, por lo que no debe interpretarse automáticamente como una transcripción completa vacía.
Los segmentos suelen ser palabras, o uno o varios caracteres en chino y japonés. Su texto omite la puntuación y puede normalizar un valor de forma distinta a la transcripción completa; no es una copia carácter por carácter de la respuesta legible. Un segmento puede tener el mismo tiempo de inicio y de fin. Utiliza los segmentos para localizar una posición de la grabación o preparar una visualización temporizada, y usa el texto completo cuando importen la redacción y la puntuación. Mantén estas dos representaciones separadas en el archivo resultante.
El idioma se detecta automáticamente, se proporcione o no una indicación opcional del idioma. El productor documenta códigos ISO 639-1 en minúsculas para estas indicaciones y devuelve un código de idioma para la lógica de la aplicación, junto con un nombre de idioma para mostrar cuando se conoce. La respuesta informa de un idioma, no de todos los idiomas de una grabación que alterna entre varios. Conserva la redacción de la fuente y los metadatos de idioma disponibles junto al resultado, en vez de tratar la petición de transcripción como una operación de traducción.
Para un flujo de subtítulos, agrupa segmentos temporizados consecutivos en entradas legibles en lugar de mostrar una palabra cada vez. Un resultado útil es un archivo SRT o WebVTT vinculado al clip original, con límites de entrada ajustados a las pausas y una cantidad manejable de texto en pantalla. Comprueba si faltan tiempos y asegúrate de que el fin de cada entrada sea posterior a su inicio. La agrupación de subtítulos y el formato del archivo son pasos de la aplicación construidos a partir de la alineación devuelta, y sus opciones de visualización deben ajustarse al reproductor y al público.
Los controles documentados de Transcribe 1 son el audio, una indicación del idioma y la elección de marcas de tiempo. Los marcadores de hablante, los turnos estructurados por hablante, los controles de eventos emocionales y las indicaciones de número de hablantes de Pro son funciones independientes; no forman parte del contrato de respuesta documentado de este modelo base. Elige el resultado necesario antes de procesar: texto legible simple para una nota, o texto junto con alineación para navegación durante la reproducción y subtítulos. Conservar el identificador del clip, la transcripción y cualquier temporización disponible hace útil ese resultado para la siguiente etapa de la aplicación.
", "aboutText": "Transcribe 1 es el modelo general de voz a texto de Fish Audio para grabaciones cortas. Acepta un archivo de audio y devuelve las palabras reconocidas como texto, junto con la duración de la grabación, segmentos temporizados opcionales e información del idioma cuando se conoce. Este modelo resulta útil para una nota de voz corta, una instrucción hablada, un fragmento de una grabación o un clip de audio que necesite una representación legible en texto.\n\nUn flujo ilustrativo de notas de voz conserva la grabación junto a su transcripción completa y un identificador del clip original. Un paso posterior de la aplicación puede buscar en ese texto, organizar la nota o elaborar un resumen conservando la fuente hablada. Para una orden, la transcripción proporciona a la aplicación las palabras reconocidas; cualquier acción es un paso independiente de interpretación y ejecución. Para un fragmento de entrevista, registra la posición del clip en el audio completo para poder comprobar una cita en el lugar correcto.\n\nEl productor acepta WAV, MP3, AAC, incluidos M4A/MP4, FLAC y Ogg con Opus o Vorbis. Las grabaciones del navegador en WebM deben convertirse a Ogg/Opus, MP3 o WAV para este modelo; Pro documenta compatibilidad nativa con contenedores adicionales. Proporciona un archivo de audio por petición. El límite documentado por petición del modelo base es de hasta 50 MiB, manteniendo los archivos MP3 y Opus por debajo de 25 MiB. El tamaño del archivo y la duración de la grabación son consideraciones distintas: un archivo comprimido puede ajustarse al límite de subida y, aun así, tardar demasiado en procesarse.\n\nTranscribe 1 está diseñado para grabaciones cortas. El productor recomienda Pro para audio de más de unos pocos minutos; una petición larga al modelo base puede fallar si supera el límite de tiempo de procesamiento. Al preparar una fuente más larga para transcribir clips cortos, conserva el desplazamiento inicial de cada clip y confirma que la transcripción devuelta cubra el clip completo antes de combinar los resultados. Suma el desplazamiento original a los tiempos locales de los segmentos para mantener la navegación vinculada a la grabación completa. Las indicaciones del modelo base no deben interpretarse como el límite independiente de 60 minutos de Pro.\n\nLa respuesta del productor incluye texto, duración y segmentos. La duración se expresa en segundos y la transcripción completa legible debe conservarse como redacción principal del clip. Las marcas de tiempo son opcionales: ignore_timestamps tiene true como valor predeterminado en la API del productor, mientras que false solicita segmentos por palabra con texto y tiempos de inicio y fin en segundos. Solicitar alineación añade tiempo de procesamiento. Un array segments vacío puede reflejar que se ha omitido la temporización, que no hay habla o que la alineación no está disponible temporalmente, por lo que no debe interpretarse automáticamente como una transcripción completa vacía.\n\nLos segmentos suelen ser palabras, o uno o varios caracteres en chino y japonés. Su texto omite la puntuación y puede normalizar un valor de forma distinta a la transcripción completa; no es una copia carácter por carácter de la respuesta legible. Un segmento puede tener el mismo tiempo de inicio y de fin. Utiliza los segmentos para localizar una posición de la grabación o preparar una visualización temporizada, y usa el texto completo cuando importen la redacción y la puntuación. Mantén estas dos representaciones separadas en el archivo resultante.\n\nEl idioma se detecta automáticamente, se proporcione o no una indicación opcional del idioma. El productor documenta códigos ISO 639-1 en minúsculas para estas indicaciones y devuelve un código de idioma para la lógica de la aplicación, junto con un nombre de idioma para mostrar cuando se conoce. La respuesta informa de un idioma, no de todos los idiomas de una grabación que alterna entre varios. Conserva la redacción de la fuente y los metadatos de idioma disponibles junto al resultado, en vez de tratar la petición de transcripción como una operación de traducción.\n\nPara un flujo de subtítulos, agrupa segmentos temporizados consecutivos en entradas legibles en lugar de mostrar una palabra cada vez. Un resultado útil es un archivo SRT o WebVTT vinculado al clip original, con límites de entrada ajustados a las pausas y una cantidad manejable de texto en pantalla. Comprueba si faltan tiempos y asegúrate de que el fin de cada entrada sea posterior a su inicio. La agrupación de subtítulos y el formato del archivo son pasos de la aplicación construidos a partir de la alineación devuelta, y sus opciones de visualización deben ajustarse al reproductor y al público.\n\nLos controles documentados de Transcribe 1 son el audio, una indicación del idioma y la elección de marcas de tiempo. Los marcadores de hablante, los turnos estructurados por hablante, los controles de eventos emocionales y las indicaciones de número de hablantes de Pro son funciones independientes; no forman parte del contrato de respuesta documentado de este modelo base. Elige el resultado necesario antes de procesar: texto legible simple para una nota, o texto junto con alineación para navegación durante la reproducción y subtítulos. Conservar el identificador del clip, la transcripción y cualquier temporización disponible hace útil ese resultado para la siguiente etapa de la aplicación.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cc35e4b56fbbe2507902dc2dc8731e75334cf4531930d63eea04f9da9d993aa6", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "fish-audio/transcribe-1Transcribe 1 convierte grabaciones de audio cortas en texto con detección automática del idioma y marcas de tiempo opcionales por palabra. Utiliza la transcripción para notas de voz, clips que puedan buscarse o preparación de subtítulos, manteniendo los segmentos temporizados separados del texto completo legible.
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.
Transcribe 1 es el modelo general de voz a texto de Fish Audio para grabaciones cortas. Acepta un archivo de audio y devuelve las palabras reconocidas como texto, junto con la duración de la grabación, segmentos temporizados opcionales e información del idioma cuando se conoce. Este modelo resulta útil para una nota de voz corta, una instrucción hablada, un fragmento de una grabación o un clip de audio que necesite una representación legible en texto.
Un flujo ilustrativo de notas de voz conserva la grabación junto a su transcripción completa y un identificador del clip original. Un paso posterior de la aplicación puede buscar en ese texto, organizar la nota o elaborar un resumen conservando la fuente hablada. Para una orden, la transcripción proporciona a la aplicación las palabras reconocidas; cualquier acción es un paso independiente de interpretación y ejecución. Para un fragmento de entrevista, registra la posición del clip en el audio completo para poder comprobar una cita en el lugar correcto.
El productor acepta WAV, MP3, AAC, incluidos M4A/MP4, FLAC y Ogg con Opus o Vorbis. Las grabaciones del navegador en WebM deben convertirse a Ogg/Opus, MP3 o WAV para este modelo; Pro documenta compatibilidad nativa con contenedores adicionales. Proporciona un archivo de audio por petición. El límite documentado por petición del modelo base es de hasta 50 MiB, manteniendo los archivos MP3 y Opus por debajo de 25 MiB. El tamaño del archivo y la duración de la grabación son consideraciones distintas: un archivo comprimido puede ajustarse al límite de subida y, aun así, tardar demasiado en procesarse.
Transcribe 1 está diseñado para grabaciones cortas. El productor recomienda Pro para audio de más de unos pocos minutos; una petición larga al modelo base puede fallar si supera el límite de tiempo de procesamiento. Al preparar una fuente más larga para transcribir clips cortos, conserva el desplazamiento inicial de cada clip y confirma que la transcripción devuelta cubra el clip completo antes de combinar los resultados. Suma el desplazamiento original a los tiempos locales de los segmentos para mantener la navegación vinculada a la grabación completa. Las indicaciones del modelo base no deben interpretarse como el límite independiente de 60 minutos de Pro.
La respuesta del productor incluye texto, duración y segmentos. La duración se expresa en segundos y la transcripción completa legible debe conservarse como redacción principal del clip. Las marcas de tiempo son opcionales: ignore_timestamps tiene true como valor predeterminado en la API del productor, mientras que false solicita segmentos por palabra con texto y tiempos de inicio y fin en segundos. Solicitar alineación añade tiempo de procesamiento. Un array segments vacío puede reflejar que se ha omitido la temporización, que no hay habla o que la alineación no está disponible temporalmente, por lo que no debe interpretarse automáticamente como una transcripción completa vacía.
Los segmentos suelen ser palabras, o uno o varios caracteres en chino y japonés. Su texto omite la puntuación y puede normalizar un valor de forma distinta a la transcripción completa; no es una copia carácter por carácter de la respuesta legible. Un segmento puede tener el mismo tiempo de inicio y de fin. Utiliza los segmentos para localizar una posición de la grabación o preparar una visualización temporizada, y usa el texto completo cuando importen la redacción y la puntuación. Mantén estas dos representaciones separadas en el archivo resultante.
El idioma se detecta automáticamente, se proporcione o no una indicación opcional del idioma. El productor documenta códigos ISO 639-1 en minúsculas para estas indicaciones y devuelve un código de idioma para la lógica de la aplicación, junto con un nombre de idioma para mostrar cuando se conoce. La respuesta informa de un idioma, no de todos los idiomas de una grabación que alterna entre varios. Conserva la redacción de la fuente y los metadatos de idioma disponibles junto al resultado, en vez de tratar la petición de transcripción como una operación de traducción.
Para un flujo de subtítulos, agrupa segmentos temporizados consecutivos en entradas legibles en lugar de mostrar una palabra cada vez. Un resultado útil es un archivo SRT o WebVTT vinculado al clip original, con límites de entrada ajustados a las pausas y una cantidad manejable de texto en pantalla. Comprueba si faltan tiempos y asegúrate de que el fin de cada entrada sea posterior a su inicio. La agrupación de subtítulos y el formato del archivo son pasos de la aplicación construidos a partir de la alineación devuelta, y sus opciones de visualización deben ajustarse al reproductor y al público.
Los controles documentados de Transcribe 1 son el audio, una indicación del idioma y la elección de marcas de tiempo. Los marcadores de hablante, los turnos estructurados por hablante, los controles de eventos emocionales y las indicaciones de número de hablantes de Pro son funciones independientes; no forman parte del contrato de respuesta documentado de este modelo base. Elige el resultado necesario antes de procesar: texto legible simple para una nota, o texto junto con alineación para navegación durante la reproducción y subtítulos. Conservar el identificador del clip, la transcripción y cualquier temporización disponible hace útil ese resultado para la siguiente etapa de la aplicación.
POST /v1/audio/transcriptionsaudiotext| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites fish-audio/transcribe-1 | Predeterminado— |
Campoinput_audio | Tipoobject | RequisitoObligatorio | Valores y límites | Predeterminado— |
| 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}
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
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 |
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_AUDIO_FILE:?Set the path to your actual PCM WAV recording}"\nexport AILOOT_AUDIO_FILE\npython3 - <<'PY_REQUEST'\nimport base64, io, json, os, wave\nfrom pathlib import Path\naudio = Path(os.environ['AILOOT_AUDIO_FILE']).read_bytes()\nif not (audio[:4] == b'RIFF' and audio[8:12] == b'WAVE'):\n raise SystemExit('Supply your actual PCM WAV audio file')\nwith wave.open(io.BytesIO(audio), 'rb') as recording:\n if recording.getcomptype() != 'NONE' or recording.getnframes() <= 0:\n raise SystemExit('Supply a nonempty PCM WAV recording')\nrequest = {'model': 'fish-audio/transcribe-1', 'input_audio': {'data': base64.b64encode(audio).decode('ascii'), 'format': 'wav'}}\nPath('request.json').write_text(json.dumps(request, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o response.bin\n# Retain the complete original response, headers and actual X-Client-Request-ID.\n# Read existing owned records for recovery; do not resubmit an uncertain operation.\nCuerpo 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 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.
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.
| Campo | Tipo |
|---|---|
Campotext (when present) | Tipo |
Campousage (when present) | Tipo |
| 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. |
Ailoot Ultra fish-audio/transcribe-1
Usa las rutas de método indicadas arriba.