modelos

Fish Audio: Transcribe 1

Markdown · JSON

Fish Audio: Transcribe 1

Transcribe 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.

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.

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.

Ailoot Ultra · Transcripción POST /v1/audio/transcriptions fish-audio/transcribe-1

fish-audio/transcribe-1

Fish Audio /fish-audio/transcribe-1

Primeros pasos

Transcribe 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.

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
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
fish-audio/transcribe-1
Predeterminado—
Campoinput_audioTipoobjectRequisitoObligatorioValores y límitesPredeterminado—
Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, input_audio
Parámetromaterial_typesContratoaudio
Parámetromaterial_conditionsContratoEl 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ónTabla de tarifasUnidad de facturaciónCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseUnidad 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 entradaTabla de tarifas—Unidad de facturaciónpor segundo de audio de entradaCargo
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 →

Solicitudes de ejemplo

Ailoot Ultra · Transcripción

curl · archivo WAV real y resultado original completo
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': 'fish-audio/transcribe-1', '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}/content
  • GET /v1/media/assets
  • GET /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
CampoTipo
Campotext (when present)Tipo
Campousage (when present)Tipo
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta400 · invalid_request_errorCondició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_errorCondiciónLa clave API de Ailoot no es válida.Siguiente pasoUsa tu clave API autorizada de Ailoot.
Respuesta403 · permission_errorCondiciónEl grupo de la clave no tiene acceso a este método.Siguiente pasoConserva los detalles del error devueltos.
Respuesta404 · not_found_errorCondiciónEl método seleccionado no tiene ninguna ruta admitida.Siguiente pasoConserva los detalles del error devueltos.
Respuesta422 · price_unavailableCondició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_errorCondició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 fish-audio/transcribe-1

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

fish-audio/transcribe-1

FAQ · Fish Audio: Transcribe 1
¿Qué entradas y resultados están disponibles?

POST /v1/audio/transcriptions · fish-audio/transcribe-1: audio → text

¿Qué campos utiliza la solicitud?

POST /v1/audio/transcriptions · fish-audio/transcribe-1: model, input_audio

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia