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. ¿Vendes más de un libro? Con Polar puedes apuntar todos tus títulos a un solo webhook en vez de crear uno cada vez. Elige «Reusar mi webhook de Polar para todos mis títulos» y Storia muestra un único endpoint para todo tu catálogo; el secreto de firma se reutiliza, así que lo pegas una sola vez. Después cada título necesita su Product ID, que es lo que permite asignar cada orden al libro correcto.
4. 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.

Los borradores no duran para siempre

Un borrador sin publicar se elimina tras 90 días sin cambios. Cualquier edición reinicia el plazo y publicarlo lo detiene por completo, así que esto solo alcanza a lo que realmente quedó abandonado. Antes te llegan dos emails: uno cuando al borrador le quedan un par de semanas y un aviso final unos días antes de la fecha. La consola muestra la fecha en el propio título cuando ya está cerca.

Puedes tener 10 borradores sin publicar a la vez. Publica o elimina uno para empezar otro. Los títulos publicados no vencen ni cuentan para el límite: ya pagaste su alojamiento.

Compartir y tokens de dispositivo

El acceso a un título restringido es un token de dispositivo (guardado en el dispositivo de quien escucha) y se entrega con un link de un solo uso. Lo que tú defines son los dispositivos activos permitidos: en cuántos dispositivos puede escucharse un mismo link de acceso.

Quien recibe el link puede compartirlo cuantas veces quiera: compartir nunca se raciona ni se agota. Lo que sí tiene límite es cuántos de sus dispositivos escuchan a la vez; al abrir el link en uno nuevo se cierra la sesión del que lleva más tiempo sin escuchar. Así una familia comparte un solo link sin problemas y aun así no puede escuchar en más dispositivos de los que permitiste. Cada link que entregas tiene su propio conjunto de dispositivos, así que un comprador nunca consume los de otro.

Ese mismo número limita cuántos links sin usar puede tener pendientes una persona a la vez: un link pendiente es un dispositivo en potencia. Aun así siempre puede compartir; se retira el link sin usar más antiguo para dejar lugar, igual que ocurre con el dispositivo más inactivo. 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, a pantalla completa: tabla de contenido, temas claro/sepia/noche, tamaño de letra, tipografía, interlineado y ancho de línea, desplazamiento o paso de páginas, y la posición guardada. Un PDF acompañante también se abre dentro de la app.
• Lectura sincronizada: cuando el título tiene tiempos —un archivo de sincronización o Media Overlays dentro del propio EPUB, el formato que usa Apple Books— el lector marca cada palabra a medida que se narra y pasa la página para seguirle el paso. Tocar una palabra lleva la narración hasta ahí.
• Leer y escuchar son una sola actividad: abrir el texto no detiene la voz; el lector sigue la narración que ya está sonando. Si dejas el libro a media página y le das play, continúa desde la frase en la que te quedaste, en cualquiera de tus dispositivos. Sin archivo de sincronización no hay nada exacto que decir, así que al cambiar se ofrece un salto opcional al capítulo correspondiente, marcado como aproximado.
• Una muestra gratis: en los títulos restringidos, un adelanto corto en el muro de pago antes de comprar.
• Reseñas: dejar una calificación y unas palabras sobre el título.

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 →