Rankinog
Continuous Planetary AI
DEVELOPER REFERENCE v4.2

Rankinog Hyperion API Documentation

The Rankinog API enables real-time ingestion, continuous spatial-spectral transformation, and anomaly detection across 512 electromagnetic spectral bands (190 nm deep UV to 14.5 µm far-infrared, plus SAR radar co-registration). All API calls execute in isolated zero-retention GPU memory enclaves.

2. Authentication

All requests to the Rankinog API must include an HTTP Authorization header containing your secret Bearer token.

Authorization: Bearer rk_live_9a4f82bc17d04e5a6b8c9d0e1f2a3b4c
Security Notice: Never expose your live API key in client-side front-end code. Use server-side proxies or edge worker runtimes.
POST /v1/hyperspectral/inference

Executes synchronous 512-band inference on planetary imagery or raster GeoTIFF files uploaded via S3 URI or base64 stream.

Request Body (JSON):
{
  "model": "hyperion-rk512",
  "image_uri": "s3://Rankinog-telemetry/permian_sector_12.tif",
  "coordinates": {
    "lat": 31.8921,
    "lon": -102.3415
  },
  "spectral_bands": 512,
  "wavelength_range_nm": [380, 14500],
  "features": [
    "methane_plume",
    "canopy_ndvi",
    "thermal_radiance",
    "sar_microwave_fusion"
  ],
  "max_latency_budget_ms": 20
}
Response (HTTP 200 OK):
{
  "status": "success",
  "model_version": "hyperion-rk512-v4.2",
  "latency_ms": 14.2,
  "bands_analyzed": 512,
  "anomalies": [
    {
      "type": "methane_plume_leak",
      "confidence": 0.9984,
      "coordinates": [31.8921, -102.3415],
      "estimated_flux_kg_hr": 428.2,
      "peak_absorption_nm": 1642.4
    }
  ],
  "zero_retention_cryptographic_proof": "0x8f4a13c9e6d72b814a0f..."
}

6. Official Python SDK

Install the official client via pip:

pip install Rankinog
Async Python Quickstart:
import Rankinog
import asyncio

client = Rankinog.Client(api_key="rk_live_xyz...")

async def main():
    result = await client.hyperspectral.analyze(
        model="hyperion-rk512",
        image_uri="s3://my-earth-vectors/quad_942.tif",
        bands=512,
        sar_radar_fusion=True
    )
    print("Latency:", result.latency_ms, "ms")
    print("Detections:", result.anomalies)

asyncio.run(main())

7. Error Codes & Rate Limits

Status Error Code Resolution
200 OK SUCCESS Inference completed within enclave.
401 Unauthorized INVALID_API_KEY Check bearer token in Authorization header.
422 Unprocessable INVALID_BAND_METADATA GeoTIFF contains unsupported raster band counts.
429 Rate Limited CONCURRENT_LIMIT_EXCEEDED Upgrade to Orbit Production or Hyperion Enterprise.