API v0.9.0

Quantum RNG Documentation

Integrate quantum-grade cryptographic entropy into your applications. Generate random numbers, cryptographic keys, and post-quantum signatures—all backed by NIST-validated quantum mechanical entropy.

Quick Start

Get your first quantum random bytes in under 5 minutes.

Key Generation

HMAC, AES, RSA, and post-quantum Dilithium keys.

API Reference

Interactive Swagger documentation for all endpoints.
7.53
bits/byte entropy
99.5%
NIST pass rate
<1μs
latency
FIPS
140-2 Level 3

Quick Start

Follow these steps to generate your first quantum random bytes.

Get Your API Key

Contact RION AI to obtain API credentials for your organization.

Email: support@rionai.com

API Key Format

Keys follow the format: qrng_ + 8-character client ID + 64-character secret

qrng_k7m2p9x4_a3b8c1d6e9f2g5h0j4k7m1n8p3q6r9s2t5u0v3w6x9y2z5a8b1c4d7e0f3

Make Your First Request

Use any HTTP client to request random bytes:

Bash / macOS / Linux:

curl -X POST "https://api.rionai.com/v1/random" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"num_bytes": 32, "format": "hex"}'

Windows PowerShell:

Invoke-RestMethod -Uri "https://api.rionai.com/v1/random" -Method POST `
  -Headers @{"X-API-Key"="your_api_key_here"; "Content-Type"="application/json"} `
  -Body '{"num_bytes": 32, "format": "hex"}'
Windows Note

PowerShell's curl is an alias for Invoke-WebRequest, not real cURL. Use the PowerShell syntax above, or use curl.exe if installed.

Receive Quantum Random Data

The API returns random bytes with cryptographic attestation:

{
  "success": true,
  "num_bytes": 32,
  "data": "a7b3c9d2e5f8...",
  "format": "hex",
  "source_id": "NDT-QRNG-001",
  "quality": "high",
  "source_min_entropy_bits_per_byte": 7.529456,
  "attestation": {
    "signature": "eyJjaXBoZXJ0ZXh0Ijoi...",
    "attestation_timestamp": "2025-12-04T12:00:00.000000"
  }
}

Verify the Attestation (Optional)

Validate that data originated from RION AI's quantum source:

Bash / macOS / Linux:

curl -X POST "https://api.rionai.com/v1/verify" \
  -H "Content-Type: application/json" \
  -d '{"data": "a7b3c9d2...", "format": "hex", "attestation": {...}}'

Windows PowerShell:

Invoke-RestMethod -Uri "https://api.rionai.com/v1/verify" -Method POST `
  -Headers @{"Content-Type"="application/json"} `
  -Body '{"data": "a7b3c9d2...", "format": "hex", "attestation": {...}}'
No Authentication Required

The verification endpoint is public—anyone can verify attestations.

Authentication

All API endpoints (except health check and verification) require authentication via API key.

API Key Header

Include your API key in the X-API-Key header:

X-API-Key: qrng_k7m2p9x4_a3b8c1d6e9f2g5h0j4k7m1n8p3q6r9s2t5u0v3w6x9y2z5a8b1c4d7e0f3

Role-Based Access

Your API key determines your rate limits and available features:

Role Rate Limit Max Bytes Key Types
basic 10/min 1,024 HMAC, AES, Custom
standard 100/min 8,192 + RSA, Dilithium2/3
premium 1,000/min 65,536 + All Dilithium variants
admin 10,000/min 65,536 All + Admin functions

NIST Compliance

RION AI implements a complete Random Bit Generator (RBG) construction in full compliance with NIST Special Publication 800-90 series.

Standard Title Implementation
SP 800-90A DRBG Mechanisms Hash_DRBG (SHA-256)
SP 800-90B Entropy Source Validation 7.529456 bits/byte validated
SP 800-90C RBG Constructions Full RBG: entropy + conditioning + DRBG
SP 800-22 Statistical Testing 99.5% pass rate (15/15 tests)

SP 800-90C RBG Construction

The API implements a full entropy source RBG per SP 800-90C:

NIST SP 800-90C RBG Construction
Entropy Source
(800-90B)
Quantum mechanical calculations 7.53 bits/byte min-entropy
Conditioning
(HKDF)
RFC 5869 HKDF Extract-Expand
DRBG
(800-90A)
Hash_DRBG (SHA-256) Prediction resistance
Output

Common Endpoints

POST /v1/random

Generate cryptographically secure random bytes with attestation.

{
  "num_bytes": 32,
  "format": "hex",
  "quality": "high"
}
POST /v1/keys/aes

Generate AES encryption keys with optional initialization vector.

{
  "key_size": 256,
  "include_iv": true
}
POST /v1/keys/dilithium

Generate post-quantum digital signature keys (NIST FIPS 204).

{
  "variant": "dilithium3",
  "use_quantum_seed": true
}
GET /v1/health

Check API health and component status. No authentication required.

Entropy Sources

RION AI derives entropy from quantum mechanical calculations performed on atomic systems. Unlike hardware-based QRNG solutions that require photon detectors or laser systems, our software-only approach extracts genuine quantum uncertainty from computational physics.

First-to-Market

RION AI is the first company to deliver software-only quantum random number generation achieving cryptographic-grade entropy (>7.5 bits/byte) validated to NIST SP 800-90B.

Cryptographic Attestation

Every response includes an HMAC-SHA256 attestation that cryptographically proves:

The attestation key is secured in IBM Key Protect HSM (FIPS 140-2 Level 3).

Next Steps

Now that you've made your first request, explore the complete documentation:

Complete User Guide

Full documentation including all endpoints, examples, and best practices.

Post-Quantum Cryptography

Prepare for quantum computing threats with Dilithium signatures.

Code Examples

Python, JavaScript, cURL, and PowerShell examples for all endpoints.