Artphorm · QeNTROPY Engine

QeNTROPY Developer API

One seed. Infinite possibilities. — Developer entropy infrastructure for games, apps, and experiments.

Live Dashboard The Q Word Quantum Dice Artphorm

Quick Start

Base URL

https://q-runtime.onrender.com

Demo API Key

qentropy-demo-key

Authenticate

x-api-key: qentropy-demo-key

Get your first seed

curl -H "x-api-key: qentropy-demo-key" \
  "https://q-runtime.onrender.com/api/seed?source=hybrid"

Authentication

Protected endpoints require an x-api-key header. During v1 beta, API keys are issued manually. The demo key grants limited access for testing.

# With API key — succeeds
curl -H "x-api-key: qentropy-demo-key" \
  "https://q-runtime.onrender.com/api/seed?source=hybrid"

# Without API key — fails
curl "https://q-runtime.onrender.com/api/seed?source=hybrid"
→ { "ok": false, "error": "Missing or invalid API key" }

Get a Seed

curl

curl -H "x-api-key: qentropy-demo-key" \
  "https://q-runtime.onrender.com/api/seed?source=hybrid"

Example response

{
  "ok": true,
  "seed": "be286ec1c6e69aa063c12566ad40d1ca...",
  "seed_bits": "1011111000101000...",
  "source": "hybrid",
  "entropy_score": 0.9998,
  "health": "excellent",
  "runtime": "Q Runtime v0.3",
  "timestamp": "2026-06-22T10:00:58.144Z"
}

JavaScript

async function getQentropySeed() {
  const response = await fetch(
    "https://q-runtime.onrender.com/api/seed?source=hybrid",
    { headers: { "x-api-key": "qentropy-demo-key" } }
  );
  const data = await response.json();
  if (!data.ok) {
    throw new Error(data.error || "QeNTROPY request failed");
  }
  return data.seed;
}

Endpoints

Method Endpoint Description API Key
GET /api/health Runtime health and online status No
GET /api/sources Lists all entropy sources and their live status No
GET /api/stats Request and usage statistics No
GET /api/seed?source=hybrid Returns a QeNTROPY entropy seed (recommended source) Required
GET /api/seed?source=ibm IBM Quantum-routed seed (routes across FEZ / Marrakesh / Kingston backends) Required
GET /api/seed?source=anu ANU_QRNG quantum seed Required
GET /api/bing-background?seed=SEED Selects a daily background image from a QeNTROPY seed No

Live entropy sources (from /api/sources)

KeyLabelDescription
localLOCALMac cryptographic entropy
ibmIBM_FEZIBM Quantum hardware — primary backend
marrakeshIBM_MARRAKESHIBM Quantum backend
kingstonIBM_KINGSTONIBM Quantum backend
braketAMAZON_BRAKETAmazon Braket quantum backend
aguAGUAGU entropy source
anuANU_QRNGANU quantum random number generator — live seed source (not yet in /api/sources — Render redeploy pending)
hybridHYBRIDBlended entropy — recommended default

Daily Stable Seed Pattern

For daily games and puzzles, cache one seed per date so the experience stays stable all day instead of changing on every page load. This is how The Q Word works.

async function getDailyQentropySeed() {
  const today = new Date().toISOString().slice(0, 10);
  const cacheKey = "qentropy_daily_seed_" + today;

  let seed = localStorage.getItem(cacheKey);
  if (seed) return seed;

  const response = await fetch(
    "https://q-runtime.onrender.com/api/seed?source=hybrid",
    { headers: { "x-api-key": "qentropy-demo-key" } }
  );
  const data = await response.json();
  if (!data.ok) throw new Error(data.error);

  seed = data.seed;
  localStorage.setItem(cacheKey, seed);
  return seed;
}

Daily Background from Seed

Use a QeNTROPY seed to deterministically select a daily background image. The Q Word uses this to set its background each day.

async function setDailyBackground(seed) {
  const response = await fetch(
    "https://q-runtime.onrender.com/api/bing-background?seed=" +
      encodeURIComponent(seed)
  );
  const bg = await response.json();
  if (bg.ok && bg.image_url) {
    document.body.style.backgroundImage = "url(" + bg.image_url + ")";
    document.body.style.backgroundSize = "cover";
  }
}

Example response

{
  "ok": true,
  "image_url": "https://www.bing.com/th?id=OHR.QuinaultFerns...",
  "title": "A lush kingdom",
  "copyright": "Quinault rainforest, Olympic National Park ..."
}

Pricing

v1 beta uses Stripe Payment Links. API keys are issued manually during beta.

FREE
$0
100 requests/day

For demos, students, hobby projects, and testing.

DEVELOPER
$7/month
1,000 requests/day
STUDIO
$29/month
10,000 requests/day
ENTERPRISE
Custom
Custom limits, support & integrations

Apps Powered by QeNTROPY

The Q Word

Daily quantum-seeded word puzzle. One QeNTROPY seed per day, stable for all players.

Open app →

Quantum Dice

QeNTROPY-seeded dice roller for games and experiments.

Open app →

Sp00ky

Quantum messenger integration — coming soon.

In development

Launch Status

QeNTROPY Engine · Artphorm · Dashboard