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 available quantum processors: Google Willow (105q), IBM Brisbane (127q), IBM Torino (133q).

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": "willow-105",
  "shots": 1024
}

AI Models

GET /api/v1/models

List available AI/ML models: L.L.M.A v2, Quantum Neural Network.

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

Run inference on a model. Supports text generation, molecular simulation, quantum cognition, and more.

Request Body: 
{
  "input": "Explain quantum entanglement",
  "parameters": {
    "max_tokens": 512,
    "temperature": 0.7
  }
}

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": "willow-105",
        "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 Google Willow
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": "willow-105",
        "shots": 4096
    }
)

result = response.json()
print(f"Circuit ID: {result['data']['circuit_id']}")
# Create a Bell state circuit on Google Willow
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": "willow-105",
    "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