VOCALSTACK PARA PAYLOAD CMS

Transcripciones como contenido

Un botón Transcribir en cada subida de audio en Payload. La transcripción se guarda en el documento como texto editable y frases con tiempos, así que tu frontend, tu búsqueda y tus API la leen como cualquier otro campo.

Ver en GitHub Obtener una clave de API

PAYLOAD 3 · NEXT.JS 15+ · DESDE $0.20 POR HORA DE AUDIO

MEDIOS · EPISODE-042.MP3Barra lateral

Transcribiendo31:06 / 48:20

json

{
  "vocalstack": {
    "status": "done",
    "language": "en",
    "transcript": "Welcome back to the show. Today…",
    "sentences": [
      { "start": 0.4, "end": 2.9, "speaker": 0,
        "text": "Welcome back to the show." }
    ]
  }
}

Un campo más

La transcripción y sus frases con tiempos están en el documento, así que la Local API, REST y GraphQL las devuelven con todo lo demás.

Progreso a la vista

El botón muestra cuánto audio se ha procesado y resiste una recarga. Detener deja el documento como estaba.

Los editores mandan

La transcripción es texto plano que un editor puede corregir. Los párrafos cambian cuando el hablante cambia o hace una pausa.

La clave se queda en el servidor

Una clave de API conectada se guarda en el servidor y no se puede leer a través de las API REST ni GraphQL.

CONFIGURACIÓN

Un plugin, una línea

Añade el plugin a payload.config.ts. Cada colección de subidas que acepta audio recibe el botón; pasa collections para elegir cuáles. Si omites la clave, un editor conecta una cuenta desde Ajustes → VocalStack.

01Instala el plugin desde GitHub y añádelo a tu configuración.

02Ejecuta payload generate:importmap. Con Postgres, ejecuta también payload migrate:create.

03Abre una subida de audio y haz clic en Transcribir.

bash

pnpm add github:vocalstack/payload-plugin

typescript

// payload.config.ts
import { vocalstackPlugin } from '@vocalstack/payload'

export default buildConfig({
  plugins: [
    vocalstackPlugin({
      // Optional: or connect from Settings → VocalStack
      apiKey: process.env.VOCALSTACK_API_KEY,
    }),
  ],
})

OPCIONES

Se adapta a como lo construiste

Valores predeterminados sensatos y un hook para cada punto en que tu configuración es distinta.

collections

Qué colecciones de subidas reciben el botón Transcribir. Por defecto, todas las que aceptan audio.

audioFields

Contenido importado que apunta a audio por nombre de archivo o enlace. Cada fila de un campo array recibe su propio botón y su transcripción.

spokenLanguage

El idioma hablado en el audio. Omítelo para detectarlo automáticamente.

fileURL

La dirección desde la que VocalStack obtiene el audio. Apúntala a tu bucket para evitar el proxy de archivos de Payload.

access

Quién puede transcribir y cambiar la conexión. Por defecto, los usuarios con sesión iniciada que pueden actualizar el documento.

PRECIOS

Sin coste por el plugin

Solo pagas a VocalStack por el audio que transcribes, con la misma tarifa que el panel y la API. Facturación por segundo, con un mínimo de 5 minutos por transcripción.

Ver precios Obtener una clave de API

ARCHIVOS$0.20por hora

Cada subida de audio y fila de array que transcribas, con hablantes, puntuación y tiempos incluidos.

Preguntas frecuentes

: Sí. Cuando el archivo no tiene una dirección pública, como en localhost o en una red privada, el plugin sube el audio en lugar de enviar un enlace.
: No. Devuelve la dirección pública del bucket desde fileURL y VocalStack obtiene el archivo directamente de allí.
: Sí. audioFields da a cada fila de un campo array su propio botón Transcribir, con una dirección que construyes a partir de la fila.
: Las frases con tiempos se guardan con su hora de inicio y fin y un hablante cada una, así que tu frontend puede mostrar subtítulos, una transcripción con clic para saltar o un reproductor sincronizado.
: Sí. La transcripción es un campo de texto del documento, y un editor puede corregirla como cualquier otro.
: Payload 3, Next.js 15 o posterior, React 19 y Node 20 o posterior.

Ver en GitHub Leer el README