Research Platform API

Programmatic access to Aevum Zenth's advanced research datasets, model training pipelines, and distributed compute infrastructure. Designed for reproducibility, scale, and strict compliance.

API Status: Stable & Operational

Authentication

All requests require a Bearer token. Tokens are scoped by division and expire after 90 days. Rotate keys via the Developer Console.

Header Format

Request Header

Authorization: Bearer aevu_res_live_8f4a2c...91x
X-Aevum-Division: research-platform
Content-Type: application/json

Endpoints

Core research operations. Base URL: https://api.aevumzenth.com/v2

GET /datasets

List all available research datasets. Supports filtering by domain, size, and licensing tier.

Query Parameters

Parameter	Type	Description
domainoptional	string	Narrow by field (e.g., genomics, climate, materials)
tieroptional	string	Filter by access tier: free, pro, enterprise
limitoptional	int	Max results (default: 20, max: 100)

Response (200)

{
  "datasets": [
    {
      "id": "ds_climate_09a2",
      "name": "Global Atmospheric Telemetry",
      "size_gb": 142.5,
      "tier": "pro",
      "updated_at": "2026-01-14T08:30:00Z"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjIwfQ"
}

POST /compute/request

Allocate GPU/TPU clusters for model training or simulation. Supports dry-run validation.

Request Body

{
  "runtime": "aevum-ml-pytorch-2.1",
  "hardware": "a100-80gb",
  "quantity": 4,
  "duration_hours": 24,
  "dry_run": false,
  "tags": ["project-omega", "q1-2026"]
}

Response (202)

{
  "job_id": "az_comp_88x92q",
  "status": "provisioning",
  "estimated_start": "2026-01-20T14:00:00Z",
  "cost_estimate_usd": 384.00,
  "webhook_url": "https://api.aevumzenth.com/v2/compute/88x92q/stream"
}

PUT /experiments/{id}/artifacts

Upload or link training artifacts, checkpoints, and evaluation metrics to a tracked experiment.

Path Parameters

Parameter	Type	Description
idrequired	string	UUID of the target experiment

Response (200)

{
  "artifact_id": "art_99m2k1",
  "checksum_sha256": "7f8a...c2d1",
  "stored_in": "s3://aevum-research-us-east-1",
  "metadata": {
    "model_type": "transformer",
    "final_loss": 0.042,
    "epochs": 12
  }
}

Error Handling

The API uses standard HTTP status codes and returns structured JSON error objects. Aevum-specific codes are prefixed with AZ_RESEARCH_.

400 Bad Request

Malformed JSON, missing required parameters, or invalid syntax. Check the details array for field-level validation errors.

401 Unauthorized

Missing or expired Bearer token. Verify your API key is active and scoped to the Research division.

AZ_RESEARCH_402

Compute quota exceeded. Your tier has reached its monthly allocation. Upgrade or request a temporary burst allowance.

503 Service Unavailable

Internal cluster maintenance or scaling delay. Retry with exponential backoff. Status page: status.aevumzenth.com

Rate Limits & Tiers

Requests are throttled based on your subscription tier. Limits are calculated per API key, per minute.

Free Tier

60 req/min
1 TB dataset storage
Shared CPU instances
Community support

Pro Tier

600 req/min
50 TB dataset storage
Reserved A100/TPU v5
Priority queue & email support

Enterprise

Unlimited req/min
Dedicated multi-region storage
Bare-metal GPU clusters
Dedicated engineering liaison & SLA