Ceramic Stability

API Surface (Draft)

JSON-first endpoint design for analysis, comparison, thermal fit checks, and report generation. Intended for repeatable studio and industrial workflows.

POST/v1/recipes/analyze
Resolve recipe materials and compute normalized chemistry foundation for downstream analysis.
POST/v1/recipes/umf
Return UMF with flux balance and network former/modifier context.
POST/v1/recipes/stability-check
Generate multi-axis risk assessment, confidence level, and missing-data diagnostics.
POST/v1/recipes/substitute
Evaluate material substitution drift and expected behavior tradeoffs.
POST/v1/materials/normalize
Normalize material records with source, LOI, and oxide mapping metadata.
POST/v1/glazes/thermal-fit
Assess thermal fit proxies against body and firing context, including crazing and shivering risk factors.
POST/v1/reports/pdf
Render versioned PDF report artifact from validated JSON report payload.

Example stability-check response shape

{
  "report_id": "rep_2026_04_30_001",
  "engine_version": "v1.0.0",
  "confidence": {
    "level": "medium",
    "score_0_to_1": 0.58
  },
  "risks": [
    {
      "risk_id": "thermal_fit.crazing.elevated_expansion_proxy",
      "severity": "elevated",
      "recommended_actions": [
        "Test on intended clay body",
        "Run boiling/freezing cycle",
        "Compare increased silica variant"
      ]
    }
  ]
}