Quantum API

Full access to Brion Quantum intelligence systems, agents, and quantum computing resources

v1.0.0 REST JSON

Quick Start

Get up and running in 3 steps

1

Get Your API Key

Create an account or sign in to generate your API key.

2

Authenticate

Include your API key in the X-API-Key header with every request.

3

Make Requests

Send requests to https://brionquantum.com/api/v1/ and start building.

# List all quantum agents
curl -X GET https://brionquantum.com/api/v1/agents \
  -H "X-API-Key: YOUR_API_KEY"
import requests

response = requests.get(
    "https://brionquantum.com/api/v1/agents",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
data = response.json()
print(data["data"]["agents"])
const response = await fetch(
  "https://brionquantum.com/api/v1/agents",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await response.json();
console.log(data.agents);

Authentication

API Key Header

All authenticated endpoints require an X-API-Key header. The root endpoint (/api/v1/) is publicly accessible without authentication.

X-API-Key: your-api-key-here

Rate Limits

TierRequests/MinuteAccess
Standard100All endpoints
Enterprise1,000All endpoints + priority queue

Response Format

All endpoints return a consistent JSON structure

{
  "success": true,
  "data": {
    // Response payload
  },
  "meta": {
    "version": "1.0.0",
    "timestamp": "2026-02-06T12:00:00.000Z"
  }
}

Endpoint Reference

Full access to quantum intelligence systems, agents, processors, and compute resources

Systems & Status

GET /api/v1/ Public

API root. Returns version info and available services. No authentication required.

GET /api/v1/status

System health and operational status for all quantum systems, agents, and processors.

GET /api/v1/systems

List all quantum intelligence systems: QVM, Quantum OS, ASI, L.L.M.A.

GET /api/v1/systems/{system_id}

Get detailed information for a specific quantum intelligence system.

Quantum Agents

GET /api/v1/agents

List all quantum agents with capabilities and performance benchmarks. Computation, Research, Security, Design, and Robotics agents.

GET /api/v1/agents/{agent_id}

Get details for a specific agent including performance stats and capabilities.

POST /api/v1/agents/{agent_id}/execute

Submit a task to a quantum agent for execution. Returns a task_id for tracking.

Request Body: 
{
  "task": "compute",
  "input": {"expression": "factor(2^128 + 1)"},
  "priority": "high"
}

Quantum Processors

GET /api/v1/quantum/processors

List quantum processors and their real current availability: the Brion statevector simulator, the 48-GPU simulator fleet, and Origin's superconducting hardware — Wukong (WK_C180, 166 calibrated qubits), WK_C180_2 and PQPUMESH8. A processor is reported available only when a circuit submitted to it will actually run.

GET /api/v1/quantum/operations

Available quantum gate operations catalog: Hadamard, Pauli, CNOT, CZ, Toffoli, parametric rotations, and more.

POST /api/v1/quantum/circuits

Submit a quantum circuit for compilation and execution on a target processor.

Request Body: 
{
  "circuit": [
    {"gate": "H", "qubit": 0},
    {"gate": "CX", "control": 0, "target": 1},
    {"gate": "M", "qubits": [0, 1]}
  ],
  "target_processor": "originq",
  "shots": 1024
}

AI Models

GET /api/v1/models

List AI/ML models with their real current status. Each model reports whether a backend can serve it, and model_card reports whether trained parameters are deployed and what accuracy they measured. A model is listed available only when a request to it will actually run.

POST /api/v1/models/{model_id}/inference

Run inference on qnn-hybrid: a trained variational quantum classifier. The circuit is executed on a real backend at request time and the response reports the measured expectation value, the decision threshold, and how far the result sits from it in units of shot noise. See Q.A.I. for the model card.

Request Body — raw feature values, in the units listed by model_card.feature_names: 
{
  "input": [6.3, 3.3, 6.0, 2.5]
}
Response: 
{
  "mode": "trained",
  "prediction": 1,
  "prediction_label": "virginica",
  "expectation": 0.9355,
  "threshold": -0.0698,
  "margin_in_shot_noise": 64.34,
  "backend": "brion-sim",
  "qubits": 4, "layers": 3, "parameters": 24,
  "shots_per_circuit": 1024
}
Custom parameters. Supply parameters.theta to run your own circuit instead of the deployed model. In that mode input must already be scaled to [-1, 1], because your parameters were not fitted with our scaler, and mode comes back as custom. Limits: 12 qubits, 8 layers, 8192 shots.
POST /api/v1/demo/qnn-hybrid

No API key required. The public demo behind the Q.A.I. page: same model, same circuit, same backend, with shots fixed server-side and a per-IP rate limit. Returns the raw measurement counts alongside the prediction, so the histogram the expectation was computed from is visible.

curl -X POST https://brionquantum.com/api/v1/demo/qnn-hybrid \
  -H "Content-Type: application/json" \
  -d '{"input": [7.6, 3.0, 6.6, 2.1]}'

TPU Fleet

GET /api/v1/tpu/fleet

TPU fleet status: 320 chips across 6 zones (v4, v5e, v6e). ~105M tasks/sec combined throughput.

POST /api/v1/tpu/jobs

Submit a TPU compute job: training, inference, simulation, or optimization.

Request Body: 
{
  "job_type": "training",
  "tpu_type": "v6e",
  "zone": "europe-west4-a"
}

Account

GET /api/v1/keys/info

Check your API key tier, rate limits, and current usage within the active window.

Error Codes

Standard HTTP status codes and error response format

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please wait before retrying.",
    "status": 429
  },
  "meta": {
    "version": "1.0.0",
    "timestamp": "2026-02-07T12:00:00.000Z"
  }
}
Status Code Description
200OKRequest succeeded
201CREATEDResource created (circuit, job, task)
400BAD_REQUESTInvalid request body or missing required fields
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENAPI key lacks permission for this endpoint
404NOT_FOUNDResource not found (invalid agent_id, model_id, etc.)
429RATE_LIMIT_EXCEEDEDToo many requests. Standard: 100/min, Enterprise: 1,000/min
500INTERNAL_ERRORUnexpected server error — please retry or contact support
503SERVICE_UNAVAILABLEQuantum processor offline or under maintenance

SDK Quickstart

Get started with Python in under 30 seconds

# Install (coming soon — use requests for now)
# pip install brion-quantum

import requests

# Configuration
API_KEY = "your-api-key-here"
BASE_URL = "https://brionquantum.com/api/v1"
HEADERS = {"X-API-Key": API_KEY}

# 1. Check system status
status = requests.get(f"{BASE_URL}/status", headers=HEADERS).json()
print(f"System: {status['data']['status']}")

# 2. List available agents
agents = requests.get(f"{BASE_URL}/agents", headers=HEADERS).json()
for agent in agents["data"]["agents"]:
    print(f"  {agent['name']}: {agent['tasks_per_sec']} tasks/sec")

# 3. Execute a task
result = requests.post(
    f"{BASE_URL}/agents/computation/execute",
    headers=HEADERS,
    json={"task": "compute", "input": {"expression": "factor(2**64 + 1)"}}
).json()
print(f"Task ID: {result['data']['task_id']}")

# 4. Run a quantum circuit
circuit_result = requests.post(
    f"{BASE_URL}/quantum/circuits",
    headers=HEADERS,
    json={
        "circuit": [
            {"gate": "H", "qubit": 0},
            {"gate": "CX", "control": 0, "target": 1},
            {"gate": "M", "qubits": [0, 1]}
        ],
        "target_processor": "originq",
        "shots": 1024
    }
).json()
print(f"Results: {circuit_result['data']['counts']}")

Code Examples

Execute a Task on a Quantum Agent

# Submit a computation task
curl -X POST https://brionquantum.com/api/v1/agents/computation/execute \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "compute",
    "input": {"expression": "optimize(portfolio, constraints)"},
    "priority": "high"
  }'
import requests

# Submit a computation task
response = requests.post(
    "https://brionquantum.com/api/v1/agents/computation/execute",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "task": "compute",
        "input": {"expression": "optimize(portfolio, constraints)"},
        "priority": "high"
    }
)

result = response.json()
print(f"Task ID: {result['data']['task_id']}")
print(f"Status: {result['data']['status']}")
// Submit a computation task
const response = await fetch(
  "https://brionquantum.com/api/v1/agents/computation/execute",
  {
    method: "POST",
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      task: "compute",
      input: { expression: "optimize(portfolio, constraints)" },
      priority: "high"
    })
  }
);

const { data } = await response.json();
console.log(`Task ID: ${data.task_id}`);
console.log(`Status: ${data.status}`);

Submit a Quantum Circuit

import requests

# Create a Bell state circuit on Origin Wukong
circuit = [
    {"gate": "H", "qubit": 0},
    {"gate": "CX", "control": 0, "target": 1},
    {"gate": "M", "qubits": [0, 1]}
]

response = requests.post(
    "https://brionquantum.com/api/v1/quantum/circuits",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "circuit": circuit,
        "target_processor": "originq",
        "shots": 4096
    }
)

result = response.json()
print(f"Circuit ID: {result['data']['circuit_id']}")
# Create a Bell state circuit on Origin Wukong
curl -X POST https://brionquantum.com/api/v1/quantum/circuits \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "circuit": [
      {"gate": "H", "qubit": 0},
      {"gate": "CX", "control": 0, "target": 1},
      {"gate": "M", "qubits": [0, 1]}
    ],
    "target_processor": "originq",
    "shots": 4096
  }'

Try the API

Test API calls directly from your browser

Response 
// Click "Send Request" to see the response

Ready to Build with Quantum Intelligence?

Request your API key and start integrating Brion Quantum systems today

Create Account & Get API Key View on GitHub