API Reference: Models

Endpoints for model registration and retrieval.

Create Model — POST /models

curl -X POST https://api.xase.ai/v1/models   -H "Authorization: Bearer xase_pk_..."   -H "Content-Type: application/json"   -d '{
    "model_id": "credit-model-v2",
    "version": "2.1.0",
    "model_hash": "sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "training_date": "2025-01-01",
    "framework": "scikit-learn",
    "performance": {"accuracy": 0.94, "auc_roc": 0.97},
    "fairness": {"demographic_parity": 0.95},
    "intended_use": "Consumer credit decisions under $100K",
    "limitations": "Not validated for business credit"
  }'

Response

{
  "model_id": "credit-model-v2",
  "version": "2.1.0",
  "model_hash": "sha256:9f86d081884c...",
  "training_date": "2025-01-01",
  "framework": "scikit-learn",
  "performance": {"accuracy": 0.94, "auc_roc": 0.97},
  "intended_use": "Consumer credit decisions under $100K",
  "limitations": "Not validated for business credit",
  "created_at": "2025-01-15T12:00:00Z"
}

Get Model — GET /models/{id}

curl -X GET https://api.xase.ai/v1/models/credit-model-v2   -H "Authorization: Bearer xase_pk_..."

Response

{
  "model_id": "credit-model-v2",
  "version": "2.1.0",
  "model_hash": "sha256:9f86d081884c...",
  "training_date": "2025-01-01",
  "framework": "scikit-learn",
  "performance": {"accuracy": 0.94, "auc_roc": 0.97},
  "intended_use": "Consumer credit decisions under $100K",
  "limitations": "Not validated for business credit",
  "created_at": "2025-01-15T12:00:00Z"
}

List Models — GET /models

curl -X GET https://api.xase.ai/v1/models   -H "Authorization: Bearer xase_pk_..."

Response

[{
  "model_id": "credit-model-v2",
  "version": "2.1.0"
}]
Model cards should include artifact hash (sha256) for verification and intended use/limitations for compliance.