Saltar al contenido principal
ShockAI Model API

Lleve sus modelos y su análisis
adonde están las mediciones

ShockAI registra lo que cada voladura realmente hizo. Traiga los modelos en los que confía su equipo, como constantes, una fórmula, un libro de cálculo o un servicio que usted aloja, y su propia forma de procesar una grabación. Cada respuesta se contrasta con las lecturas, junto al estándar de la plataforma. Nuestros propios modelos ya se ejecutan sobre el contrato publicado sobre el que usted puede desarrollar hoy.

Vista previa para sociosv0

La Model API está en vista previa para socios. Trabajamos con socios seleccionados de las plataformas de análisis del sector para dar forma a la v1 antes de la disponibilidad general.

Cuatro formas de traer un modelo

Parta de aquello en lo que su equipo ya confía

Todas las formas terminan en el mismo lugar: un modelo que la plataforma ejecuta sobre el caso de la voladura, que responde con un P50 y un P95 y se contrasta con lo que se midió. Elija la que se ajuste a cómo vive hoy su modelo.

  • Acceso anticipado

    Sus constantes

    Su ley del sitio o su ley de onda aérea, con las constantes que usted ajustó. Ingréselas una vez; se ejecutan en cada voladura.

    Usted trae
    K y β, la dispersión y el rango en el que se sostiene su ajuste.
    La plataforma
    Las ejecuta con el motor de ley del sitio o de onda aérea propio de la plataforma, con rechazo en campo cercano e intervalos de predicción incluidos.
  • Acceso anticipado

    Su fórmula

    Escriba la ecuación que usa su equipo. Se ejecuta tal como está escrita y se lee como una ecuación, no como una caja negra.

    Usted trae
    La ecuación, sus entradas y algunas respuestas que da su hoja de cálculo para comprobarla.
    La plataforma
    La comprueba con sus respuestas, la compone como ecuación en la tarjeta del modelo y la ejecuta en cada voladura.
  • Acceso anticipado

    Su libro de cálculo

    La hoja de cálculo en la que confían sus ingenieros, convertida en un modelo que la plataforma ejecuta.

    Usted trae
    El libro de cálculo y las celdas que contienen su respuesta.
    La plataforma
    Nuestros ingenieros lo convierten con usted en una llamada, así que el libro de cálculo se queda en su computadora.
  • Acceso anticipado

    Su propio host

    Cualquier modelo, en cualquier lenguaje, en un servidor que usted controla. Conservamos su dirección, su manifiesto, sus claves públicas y sus respuestas. Nunca el modelo.

    Usted trae
    Un servicio que responde a la Model API, partiendo de nuestra plantilla en TypeScript o Python.
    La plataforma
    Lo comprueba con el conjunto de pruebas de conformidad, envía cada caso firmado y recortado a lo que declara, y conserva sus respuestas.
Vista previa para socios

Todas las formas se ejecutan sobre el mismo contrato publicado que nuestros propios modelos.

shockai/site-law@3.0.0sha256:a39b9b68…343c

Nuestro modelo de ley del sitio sobre el ejemplo publicado: un banco de 32 barrenos con 4 receptores. R4 queda fuera del rango ajustado, así que su respuesta lo dice.

PPV predicha en cada receptor
ReceptorDistancia escaladaP50 (mm/s)P95 (mm/s)Validez
R11416.428.4Dentro
R2237.813.2Dentro
R3383.45.9Dentro
R4551.93.3Extrapolado

R4: como máximo 444 kg por retardo mantienen su P95 bajo 5 mm/s.

  1. 01El caso32 barrenos · 4 receptores · ley del sitio
  2. 02El modeloEl nuestro, o el suyo
  3. 03P50 y P953 declinadas, cada una con un motivo
  4. 04Contrastado con la lecturaDespués de la voladuraBajo el P50 · Dentro del P95 · Sobre el P95Vista previa para socios
Traiga su propio análisisAcceso anticipado

Procese las grabaciones a su manera, junto a la nuestra

Cómo la aceleración se convierte en velocidad es una elección, y los especialistas la toman de distinta manera. Ajuste la cadena de procesamiento de vibración sobre un registro simulado con una respuesta conocida, o sobre uno real, guárdela como la receta de su equipo y ejecútela sobre sus eventos. El análisis estándar de la plataforma queda exactamente como está.

Lo que usted ajusta

  • La frecuencia de corte del pasa altos y su orden
  • Cómo se elimina la tendencia del registro
  • La banda en la que se lee el espectro

Lo que no cambia

  • Cada cifra proviene del propio servicio de análisis de la plataforma, el motor detrás del estándar.
  • Una receta que recortaría vibración real dentro de sus curvas de cumplimiento se marca antes de que pueda guardarla.
  • Los resultados se muestran junto al estándar de la plataforma, marcados donde el pico o el veredicto difieren.

Ajuste cómo una grabación se convierte en velocidad, sobre un registro real o simulado. Guárdelo como la receta de su equipo y ejecútelo junto al estándar de la plataforma.

Lo que sigue siendo suyo

Su modelo es su propiedad intelectual. Construimos en torno a eso.

La plataforma necesita ejecutar su modelo, no guardarlo. Esto es lo que eso significa, y dónde están los límites.

  • Custodia cero en su propio host

    Acceso anticipado

    Conservamos la dirección, el manifiesto, las claves públicas y las respuestas. El modelo, sus archivos y sus constantes se quedan en su servidor.

  • Su libro de cálculo se queda con usted

    Acceso anticipado

    Lo convertimos con usted en una llamada, así que el archivo nunca sale de su computadora.

  • Compartido por concesión, solo para ejecutar

    Acceso anticipado

    Dé a un equipo cliente su modelo para que lo ejecute. Ven su tarjeta, nunca su contenido.

  • Junto al estándar

    Acceso anticipado

    Sus respuestas aparecen junto a las de la plataforma. Los informes de cumplimiento siguen citando el estándar de la plataforma.

Límites honestos

  • Custodia cero no es conocimiento cero. Para ejecutar su modelo le enviamos un caso y conservamos su respuesta, así que vemos cómo se comporta en los casos que responde.
  • Una ley simple puede deducirse a partir de unas pocas de sus respuestas. Cualquiera a quien usted permita ejecutarla podría recuperar sus constantes: compartir es licenciar con un registro de auditoría, no mantener un secreto.
  • Cuando ejecuta un modelo que otro aloja, su caso viaja al servidor de esa parte. Verá adónde antes de la primera ejecución.
Por qué ejecutarlo aquí

Lo difícil del modelado son los datos. Nosotros los recopilamos.

  • Entradas calibradas, no supuestasUn caso lleva las leyes ajustadas del propio sitio para la vibración del terreno y la onda aérea, con las estadísticas del ajuste que necesita un intervalo de predicción, junto al diseño, los receptores y sus límites. El contrato también define formas de onda semilla, VoD medida y registros de detonadores, y los casos los llevarán a medida que la plataforma los complete. Su modelo se calibra con datos de campo, no con propiedades de la roca que nadie puede medir.
  • Predicciones puntuadas frente a la realidadDespués de la voladura, cada predicción registrada se contrasta con la lectura en el mismo receptor: bajo el P50, dentro del P95 o por encima de él. Los modelos propios de la plataforma se puntúan así y, en acceso anticipado, también los propios de un equipo, incluidos los conectados. El sesgo y la cobertura a lo largo del tiempo, por sitio, son lo siguiente.
  • Resultados donde se toman las decisionesLas respuestas de un modelo aparecen junto a las de la plataforma en la página de la voladura, cada una guardada con su modelo, versión y caso, y una respuesta de movimiento se dibuja sobre la voladura en el Visualizador. Los informes de voladura citan los modelos propios de la plataforma.
  • Un contrato, todos los sitiosImplemente cinco endpoints una sola vez, contra un documento OpenAPI 3.1 publicado y JSON Schemas. Cada caso indica las condiciones del propietario de sus datos, cada ejecución lleva una clave de idempotencia, y un caso idéntico se responde desde la caché en lugar de ejecutarse dos veces.
Cómo funciona una ejecuciónVista previa para socios

Del registro medido a la predicción puntuada

  1. 01La plataforma arma un BlastCaseEl diseño, los receptores y sus límites, las leyes ajustadas del sitio y la pregunta que se hace, reducidos mediante hash a un id de caso.
  2. 02Envía lo que su manifiesto declaraUn POST /runs firmado que lleva solo las entradas que su modelo dice leer.
  3. 03Usted devuelve un ModelResultSalidas tipadas con percentiles, un veredicto de validez y la procedencia, o un motivo por cada salida que usted declina.
  4. 04El resultado se guarda en caché, se muestra y se citaIndexado por id de caso y versión del modelo, mostrado en la página de la voladura y citado en el informe de voladura.
  5. 05La voladura se dispara y se mideLos valores predichos y los medidos se comparan en cada receptor que registró.
Qué puede responder un modelo

Catorce tipos de salida, un solo contrato

Cada tipo es una respuesta tipada a una pregunta que los ingenieros de voladura ya se hacen. Los modelos de referencia de la plataforma responden los diez primeros. El resto está abierto a los socios.

  • Velocidad pico de partículaModelo de referencia
    receiver_ppvEn estructuras, monitores y linderos, con la probabilidad de excedencia frente al límite del receptor.
  • Carga por retardoModelo de referencia
    max_chargeLa mayor carga por retardo cuyo percentil de diseño se mantiene bajo el límite de un receptor: la cifra con la que se planifica una voladura.
  • Onda aéreaModelo de referencia
    airblastSobrepresión pico en los receptores.
  • Daño en campo cercanoModelo de referencia
    damage_envelopeRadios y envolventes de daño para el control de paredes y la dilución.
  • Campo de deformaciónModelo de referencia
    strain_fieldExtensión pico de la roca sobre una cuadrícula en planta a la profundidad de las cargas: dónde una voladura deforma la roca más allá de su resistencia, y cuánto.
  • Proyección de rocasModelo de referencia
    flyrock_zoneAlcance máximo por mecanismo, con distancias de despeje.
  • FragmentaciónModelo de referencia
    fragmentation_curveDistribución de tamaños, X50 y X80.
  • Movimiento del burdenModelo de referencia
    movement_fieldDónde parte y dónde queda en reposo cada bloque del burden (piedra), cuándo sale y cuánto tarda, dónde cae primero al terminar su vuelo, y la pila de material volado que forma.
  • Diagnóstico de barrenosModelo de referencia
    hole_diagnosisDespués de la voladura: qué hizo cada barreno, leído de los registros de movimiento del terreno de la propia voladura y de su registro de disparo, con un nivel de confianza y el razonamiento que lo sustenta.
  • Ajuste de amplitud de deformaciónModelo de referencia
    strain_amplitudeDespués de la voladura: el factor sobre la amplitud de campo cercano de un modelo de daño que hace que sus radios sean la sobreexcavación observada detrás de la última fila, para que lo lleven las voladuras posteriores del sitio.
  • Historias temporales del movimiento del terrenoAbierto para su modelo
    receiver_waveformTrazas predichas de tres componentes, por ejemplo por superposición de formas de onda semilla.
  • Contenido de frecuenciasAbierto para su modelo
    receiver_spectrumEspectros de amplitud predichos en los receptores.
  • Campo de vibraciónAbierto para su modelo
    ppv_fieldPPV sobre una cuadrícula en planta, en el percentil elegido.
  • Optimización de tiemposAbierto para su modelo
    timing_proposalTiempos de disparo propuestos frente a un objetivo declarado.
ConformidadVista previa para socios

16 comprobaciones que supera todo modelo, los nuestros primero

El conjunto de pruebas comprueba las promesas del contrato, no sus cifras: la exactitud se puntúa frente a las mediciones, después de la voladura. Nuestros propios modelos lo superan en cada cambio; su servicio pasa por él cuando se conecta.

  1. 01El manifiesto es un documento válido.manifest.valid
  2. 02Un modelo asíncrono declara las claves con las que se firman sus callbacks.manifest.async-declares-callback-keys
  3. 03Cada resultado es un ModelResult válido.result.valid
  4. 04Un resultado nombra el caso que respondió.result.pinned-to-case
  5. 05Un resultado nombra el modelo y la versión que lo produjeron.result.pinned-to-model
  6. 06Cada pregunta que hace el caso se responde, o se declina con un motivo.result.every-question-answered
  7. 07No se responde nada que no se haya preguntado.result.only-what-was-asked
  8. 08Una respuesta dada barreno por barreno nombra los barrenos del propio caso, una vez cada uno, y un diagnóstico no deja fuera ningún barreno cargado.result.holes-in-design
  9. 09Un punto que un modelo pone en movimiento toca el suelo no más tarde de cuando queda en reposo.result.touchdown-within-flight
  10. 10Un campo que declara sus puntos como fuentes declara una por cada punto que se mueve.result.sources-for-every-flight
  11. 11El modelo lee solo las entradas que su manifiesto declara.result.reads-only-declared-inputs
  12. 12El resultado dice qué entradas leyó.result.declares-what-it-read
  13. 13El mismo caso da la misma respuesta.result.deterministic
  14. 14Los datos que el modelo no lee no cambian nada.result.ignores-undeclared-inputs
  15. 15Los mismos bytes detrás de otro enlace dan la misma respuesta.result.ignores-blob-uri
  16. 16Una entrada obligatoria ausente se declina, no se adivina.result.declines-without-required-input
Modelos de referencia

Nuestros modelos usan la misma interfaz

Los modelos propios de la plataforma fueron los primeros proveedores de la interfaz, y superan el mismo conjunto de pruebas de conformidad que superará el suyo. Son el estándar de la plataforma: la respuesta junto a la que se muestra cualquier otro modelo.

  • Site lawshockai/site-law@3.0.0

    Far-field peak particle velocity from the scaled-distance law fitted to the site’s own readings, with Student-t prediction intervals from the fit, and the largest charge per delay a receiver’s limit allows.

    empiricalreceiver_ppvmax_chargeSíncronaIncluido
  • Airblast lawshockai/airblast@1.0.0

    Peak overpressure from the cube-root scaled-distance law fitted to the site’s own microphone readings, with Student-t prediction intervals.

    empiricalairblastSíncronaIncluido
  • Kuz-Ram fragmentationshockai/kuz-ram@1.0.0

    Mean fragment size by Kuznetsov and a Rosin-Rammler distribution by Cunningham’s uniformity index, per hole and for the blast.

    empiricalfragmentation_curveSíncronaIncluido
  • Flyrock rangeshockai/flyrock@1.1.0

    Face-burst and cratering throw by Richards and Moore from each hole’s burden, stemming and charge per metre, each hole read at its stemming as loaded where the case records it, with each hole’s ranges and clearance distances.

    empiricalflyrock_zoneSíncronaIncluido
  • Hole healthshockai/hole-health@2.0.0

    What each hole of a fired blast did, read from the blast’s own ground-motion records and its detonator log: fired on time, late or early, not detected, weak or strong, each with a calibrated confidence and the hole’s own motion as the working behind it.

    kinematichole_diagnosisSíncronaIncluido
  • Kinematic movementshockai/kinematic-movement@0.10.0

    Where a bench blast throws its burden and how the muckpile settles: each hole’s rock launched by its charge at its designed firing time, its face bulging mid-height, down the firing-time gradient, its stemming heaved mostly upward, confined by the bench beside and behind so that it leaves only through the free face and over the bench top, rows behind the face thrown only as far as the rock ahead makes room, flown ballistically, piled at its angle of repose, rock the pile closes on resting in it.

    kinematicmovement_fieldSíncronaIncluido
  • Strain damageshockai/strain-damage@0.4.0

    Which rock a blast strained past its strength: every hole's column-source P wave, near field included, superposed at its firing time and judged in strain against Hoek–Brown's criterion through Hooke's law; per hole, the radius at which it is passed, and the peak extension over a plan-view grid at the charges' depth.

    hybriddamage_envelopestrain_fieldstrain_amplitudeSíncronaIncluido
La forma de una integración

Una ejecución síncrona, de principio a fin

La plataforma firma una solicitud y envía un caso; su servicio verifica la firma, ejecuta su modelo y responde con una ejecución. El caso es el ejemplo publicado (un banco de 32 barrenos con cuatro receptores) tal como la plataforma lo envía a un modelo de ley del sitio: recortado a las entradas que ese modelo declara. Aquí las listas largas se acortan, y la firma cubre exactamente el texto mostrado.

POST /shockai/v0/runs HTTP/1.1
Host: models.example.com
Content-Type: application/json
Idempotency-Key: run_01J8Z5V3Q4K7M2N9P6R8S0T1U3
ShockAI-Signature: t=1790000000,kid=kPrK_qmxVWaYVA9wwBF6Iuo3vVzz7TxHCTwXBygrS4k,ed25519=LhvdhnM12gb90YYEc4mzjYR6TTXEYH_W8OfLEtQRoYnOUu3meoOJma1M-yF1aa_t_LK7RNHjLBBIK4scdbamAw

{
  "case": {
    "specVersion": "0.1",
    "caseId": "sha256:a39b9b6879f0ada629e40e51724e0ca69b4aad0466969ea2da88c4461acc343c",
    "createdAt": "2026-09-26T00:00:00Z",
    "coordinateSystem": {
      "kind": "local",
      "name": "Bench 12 local grid",
      "gridBearingDeg": 0,
      "origin": {
        "latitude": -22.6012,
        "longitude": 117.8421
      }
    },
    "site": {
      "domains": []
    },
    "design": {
      "holes": [
        {
          "id": "H01",
          "row": 1,
          "column": 1,
          "collar": {
            "x": 0,
            "y": 0,
            "z": 0
          },
          "toe": {
            "x": 0,
            "y": 0,
            "z": -13
          },
          "diameterMm": 165,
          "domainId": "hard",
          "burdenM": 4.5,
          "spacingM": 5.5,
          "subdrillM": 1,
          "decks": [
            {
              "kind": "stemming",
              "topDepthM": 0,
              "bottomDepthM": 3.5
            },
            {
              "kind": "explosive",
              "topDepthM": 3.5,
              "bottomDepthM": 13,
              "productId": "bulk-emulsion",
              "massKg": 253.9
            }
          ],
          "delay": {
            "totalMs": 0,
            "surfaceMs": 0,
            "downholeMs": 0
          }
        },
        "… 31 more"
      ],
      "products": [],
      "maxInstantaneousCharge": {
        "massKg": 253.9,
        "windowMs": 8
      },
      "pattern": "staggered"
    },
    "receivers": [
      {
        "id": "R1",
        "name": "Pit rim",
        "kind": "monitor",
        "position": {
          "x": -80.8,
          "y": -210.8,
          "z": 0
        },
        "distanceM": 225.9,
        "distanceSource": "placement"
      },
      "… 3 more"
    ],
    "request": {
      "outputs": [
        "receiver_ppv",
        "max_charge"
      ],
      "percentiles": [
        50,
        95
      ],
      "designPercentile": 95,
      "seed": 20260926
    },
    "consent": {
      "purpose": "prediction",
      "retention": "none",
      "allowTraining": false
    },
    "calibration": {
      "siteLaw": {
        "metric": "ppv",
        "basis": "pvs",
        "scaling": "square_root",
        "k": 1140,
        "beta": 1.6,
        "sigmaLn": 0.3,
        "n": 24,
        "scaledDistance": {
          "min": 12,
          "max": 45
        },
        "fit": {
          "dof": 22,
          "meanLnScaledDistance": 3.2189,
          "sxx": 3.48
        },
        "frequencyBins": [
          {
            "log10SdMin": 1,
            "log10SdMax": 1.1667,
            "medianHz": 31,
            "count": 7
          },
          "… 2 more"
        ],
        "source": "platform_fit"
      }
    }
  }
}
En la beta cerrada

Un modelo llega a la plataforma a través de un equipo

ShockAI está en beta cerrada. Un equipo conecta un modelo en un host que él mismo opera, y sus respuestas se guardan en las voladuras de ese equipo. Las funciones que eso requiere son unas a las que incorporamos a los equipos de uno en uno. Así está cada una.

  • Modelos del equipoPor invitación
    Beta v0.2Los modelos propios de un equipo, listados en su página Modelos en los ajustes del equipo y ejecutados junto a los de la plataforma en los proyectos que los eligen.
  • Modelos conectadosPor invitación
    Experimental v0.3Un modelo en un host que usted opera, llamado mediante la Model API. Primero requiere Modelos del equipo.
  • Ejecuciones de modelos registradasPor invitación
    Beta v0.4Las ejecuciones de los modelos propios de la plataforma en la página de la voladura, guardadas y puntuadas. Las ejecuciones de los modelos propios de un equipo aparecen allí sin esta función.
  • Capa de movimientoPor invitación
    Experimental v0.1El movimiento del burden de un modelo conectado, dibujado sobre la voladura en el Visualizador.
  • Visualizador ShockAIPor invitación
    Beta v0.8La escena 3D en la que se dibuja la capa de movimiento. En un equipo requiere una licencia Pro.

Un propietario o administrador del equipo solicita una función que es por invitación, y activa una que es propia del equipo, en Ajustes, en Funciones beta. Respondemos al equipo. Con Modelos del equipo viene el espacio de nombres de modelos del equipo, que ShockAI asigna: la primera parte de cada id de modelo que el equipo publica.

Alojar su modelo

Dos formas de entrar

Vista previa para socios

Integre su producto

Usted desarrolla software de modelado de voladuras, fragmentación, geotecnia o diseño. Trabaje con nosotros en el contrato v0, parta de una plantilla de host y conéctese.

Iniciar una conversación
Acceso anticipado

Traiga los modelos de su equipo

Constantes, una fórmula, un libro de cálculo, un servicio que usted aloja o su propio procesamiento. Cuéntenos qué tiene; el acceso anticipado se abre equipo por equipo.

Solicitar acceso anticipado