Documentación

Todo lo que necesitas para publicar, restringir y vender tus audiolibros y cursos en audio en Storia.

Primeros pasos

Storia funciona sin contraseñas. Abre la consola para editoriales, escribe tu email y haz clic en el link mágico que te enviamos: eso te da acceso y crea tu cuenta en un solo paso. Las sesiones duran 60 días por dispositivo. La primera vez aceptarás los Términos del Servicio antes de poder publicar.

Crear y publicar un título

Empieza desde el panel. Ponle nombre al título y presiona Crear o, si ya tienes un archivo terminado, suelta el M4B, el EPUB o el .lpf directamente sobre el campo. Al importar se crea el título, se divide en capítulos y se llenan los datos, la portada y los metadatos antes de que escribas nada. En Importar verás qué te da cada formato.

Después estás en el asistente, un paso a la vez, con pestañas arriba para volver a cualquier cosa más tarde. Cada paso se guarda al salir de él: no hay un botón Guardar aparte que olvidar, ni forma de perder lo que hiciste por avanzar.

Los pasos opcionales se pueden omitir, y omitir significa exactamente eso: no se guarda nada y puedes volver a la pestaña cuando quieras. El flujo se adapta a tus respuestas: un título público nunca te muestra Pago ni Compartir, porque no tiene muro de pago que configurar. Marca «Privado» en el paso de Acceso y los dos aparecen justo después.

Importar un libro terminado

La importación ocurre en tu navegador: el archivo se abre, se lee y se divide en tu propia máquina, y solo se suben las piezas terminadas. No se recodifica nada, así que el audio que reciben tus oyentes es idéntico al que hiciste. Tres formatos:

Míralo antes de publicar. Con la sesión abierta puedes entrar al reproductor de tu propio título en /p/<slug> y reproducirlo todo, incluso un borrador sin publicar o un título restringido, sin token de dispositivo ni compra. Solo tú, como propietario, lo ves; los demás siguen necesitando que esté publicado y, si es restringido, un link de acceso.

Muestra gratis (opcional). Cada título puede llevar una muestra corta de audio que suena en su muro de pago antes de la compra. Intentamos extraer una automáticamente de tu primer archivo al subirlo; también puedes subirla o reemplazarla desde la consola, o quitarla. La muestra se sirve abiertamente (incluso en un título restringido) para que se pueda probar antes de comprar.

Hazte encontrar (opcional). Marca «Incluir en el catálogo público» en un título publicado y aparecerá en Discover, donde quienes disfrutan la experiencia de Storia pueden encontrar más contenido. Está desactivado por defecto: tu título permanece fuera del catálogo hasta que lo actives.

Acceso público o restringido

Cada título es público (cualquiera con el link puede escuchar) o restringido (hace falta un link de acceso). Los títulos restringidos muestran un muro de pago que deliberadamente no es una PWA, para que ningún navegador ofrezca instalar una app detrás de un muro de pago, con tu portada, la descripción, una opción de compra y un email de contacto para recuperar el acceso perdido.

Vender el acceso con tu propio procesador

Conecta tu propia cuenta de pagos para que te paguen a ti directamente: el dinero nunca pasa por Storia y no repartimos ingresos. Con un pago confirmado emitimos un link de acceso de un solo uso y se lo entregamos a quien compró.

Modo link (recomendado, sin API key)

1. Crea un link o producto de pago alojado en tu procesador (Polar, Stripe, Square, Lemon Squeezy o Paddle).
2. Agrega en tu procesador la URL del webhook que aparece en la consola y pega aquí su secreto de firma.
3. Pega tu link de pago y define un precio. Eso es todo: quien compre va a tu página de pago y recibe su link de acceso por email después de pagar.

Desbloqueo instantáneo (opcional). Pon como URL de éxito o redirección de tu link de pago la URL de canje que aparece en la consola. La mayoría de los procesadores (Polar, Stripe, Lemon Squeezy, Paddle, Square) agregan el id de la orden al devolver a quien compró, y Storia lo usa para desbloquear el dispositivo de inmediato, sin necesidad de abrir el email. Si un procesador no redirige, el link enviado por email sigue funcionando.

Modo API (redirección continua)

Danos la API key de tu procesador y Storia crea cada pago por su cuenta, de modo que tras pagar se regresa directo al reproductor. PayPal usa este modo.

Páginas combinadas de «elige tu edición» (opcional)

Desde la consola puedes agrupar varios de tus títulos en una colección: una sola página que puedes compartir en /c/tu-slug y que deja elegir entre ellos. Cada título muestra su propia muestra gratis y enlaza a su propio pago por separado, así que es ideal para variantes (distintos narradores, idiomas o ediciones) sin fusionarlas en una sola publicación. Tus títulos siguen siendo completamente independientes; en la página solo aparecen los publicados.

Compartir y tokens de dispositivo

El acceso a un título restringido es un token de dispositivo (guardado en el dispositivo de quien escucha). Puedes crear links de un solo uso tú mismo y, si quieres, darle a quien lo reciba un margen para volver a compartir para que pase el acceso a otros; ese margen se reduce al delegarlo, así que no se sale de control. Si alguien se queda sin dispositivos, puede transferir uno para liberar un lugar. Revoca cualquier token cuando quieras desde la consola.

Dónde se puede escuchar

Los derechos de audio suelen ser territoriales, así que cada título se puede limitar a los países donde tienes los derechos, o publicarse en todas partes menos en algunos. Configúralo en Dónde se puede escuchar en la consola: elige la restricción, escoge los países y guarda.

Quien esté fuera del conjunto permitido verá una página breve que explica que la editorial no puso el título a disposición en su región (con tu email de contacto, si lo configuraste), en lugar de un callejón sin salida o un «no encontrado». La restricción cubre el reproductor, el audio en sí, el ebook y el muro de pago: no tiene sentido vender un acceso que no vamos a entregar. Tú, como propietario, siempre puedes llegar a tu propio título desde cualquier lugar, así que puedes revisarlo mientras viajas.

La ubicación viene de la red, y a quienes no se les puede determinar el país se les deja pasar en vez de bloquearlos. Tómalo como una barrera de buena fe que cumple con una obligación de derechos, no como un candado: cualquiera con una VPN puede rodearla.

Lo que recibe quien escucha

• Un reproductor instalable y sin conexión: se descarga una vez, se escucha en cualquier parte, sin cuenta.
• Continuar en otro dispositivo: sincronización opcional del avance en la nube dentro de su árbol de acceso.
• Un lector de ebooks integrado: agrega el EPUB acompañante y se podrá leer dentro de la app (tabla de contenido, tamaño de letra, posición guardada). Cuando el título tiene tiempos de lectura sincronizada —un archivo de sincronización o Media Overlays dentro del propio EPUB (la lectura sincronizada de EPUB 3, el formato que usa Apple Books)— el lector resalta cada línea a medida que se narra.
• Cambiar entre escuchar y leer: el lector recuerda en qué modo se quedó y vuelve a abrir ahí. La lectura sincronizada se mantiene exacta. Sin ella, al cambiar se ofrece un salto opcional al capítulo correspondiente: exacto cuando un archivo de sincronización declara qué sección va con qué capítulo, y marcado como aproximado cuando tenemos que adivinarlo por los nombres de los capítulos.
• Una muestra gratis: en los títulos restringidos, un adelanto corto en el muro de pago antes de comprar.
• El ebook acompañante y las reseñas: leer o descargar el EPUB o PDF que adjuntaste, y dejar una calificación.

Archivo de sincronización de lectura

El archivo de sincronización mantiene el ebook y la narración a la par. Su verdadero trabajo es la posición: quien cambia entre leer y escuchar llega justo donde se quedó, en el punto correcto, y no a una estimación. Cuando los tiempos son lo bastante finos, el lector además resalta la frase que se está diciendo, pero eso es el adorno, no el objetivo, y se puede desactivar.

Storia obtiene esa alineación de una de cuatro maneras:

• EPUB con Media Overlays: al importarlo generamos el archivo de sincronización a partir del SMIL del libro, con el nivel de detalle con el que se haya creado. No tienes que hacer nada.
• Paquete LPF: el archivo de sincronización viaja dentro del paquete como recurso.
• Lo subes tú: si tienes tiempos palabra por palabra de tu proceso de producción, el formato está abajo.
• Generado a partir de tus capítulos: casi nadie que produce un M4B tiene tiempos palabra por palabra, así que la consola ofrece armar una sincronización por capítulos: empareja cada sección de tu ebook con el capítulo que la narra y le da una marca que abarca ese capítulo. Con este nivel de detalle no se resalta nada —no hay frase a la que apuntar— pero cambiar entre leer y escuchar pasa de ser aproximado a ser exacto. Un clic en Sincronización de lectura, y más adelante puedes reemplazarlo por un archivo más fino.

Llegue como llegue, el archivo de sincronización es contra lo que reproduce el lector: sus marcas apuntan al audio de los capítulos del propio título, así que la lectura sincronizada sigue funcionando después de que edites, reemplaces o vuelvas a temporizar un capítulo. (Un EPUB que subas directo a la ranura del ebook con sus overlays y su audio adentro también es lectura sincronizada: el lector recurre a ellos.)

El formato es JSON simple. Los tiempos van en segundos, relativos al inicio de la pista a la que se refieren — no a todo el libro — y track es una posición de base 1 en el orden de lectura:

{
  "type": "storia-sync",
  "version": 1,
  "sections": [
    {
      "href": "OEBPS/ch01.xhtml",
      "track": 1,
      "cues": [
        { "id": "w1", "start": 0,    "end": 0.42 },
        { "id": "w2", "start": 0.42, "end": 0.98 }
      ]
    }
  ]
}

• href — el documento del spine dentro de tu EPUB. Se empareja por la ruta completa y, si no, por el nombre del archivo, así que cualquiera de las dos sirve.
• track — a qué audio de capítulo pertenecen estas marcas (1 = primer capítulo del orden de lectura).
• id — opcional: el atributo id del elemento que se resalta en ese documento. Si lo omites, la marca igual ubica ese tramo de audio dentro de ese documento, que es todo lo que un archivo por capítulos puede afirmar con honestidad y basta para mantener los dos medios a la par. Un archivo por capítulos generado se ve así: { "start": 0, "end": 930.5 }.
• start / end — segundos dentro del audio de ese capítulo. Las marcas deben ir en orden y no traslaparse; que se toquen (end igual al start siguiente) está bien.
• text — opcional, el reproductor lo ignora. Útil cuando lo escribes a mano.

El nivel de detalle lo decides tú: una marca por palabra da un efecto karaoke; una por oración o por párrafo es más tranquila y produce un archivo mucho más pequeño. Cualquier cosa mal formada se rechaza al subirla indicando el problema específico, para que puedas corregirla y volver a intentarlo.

Preguntas frecuentes

¿Storia se queda con parte de mis ventas?

No. Solo pagas la cuota fija de alojamiento. Las ventas van a tu propio procesador (solo pagas sus comisiones).

¿Quienes compren necesitan una cuenta?

No. El acceso es un token de dispositivo que llega por link o por email, sin registrarse.

¿Puedo mover mis archivos después?

Sí: tú subes tus propios archivos y puedes descargarlos o eliminarlos cuando quieras.

¿Tengo que convertir mi M4B antes de subirlo?

No. Storia lo lee y lo divide en tu navegador, y copia los cuadros de audio tal cual, sin recodificar, así que no se pierde nada y no hay que instalar nada.

¿Se sube todo mi M4B?

No. Solo se suben los capítulos en los que se divide, que son el mismo audio sin la carga extra del contenedor original. Leer el archivo para encontrar los capítulos ocurre en tu máquina y no sube nada.

Abrir la consola →