POST /api/v1/bench/run

{
  "backend_id": "statevector_sim",
  "workloads": ["bell_state", "ghz_5q", "ghz_10q"],
  "shots": 1024,
  "seed": 42
}

curl -X POST https://api.softquantus.com/api/v1/bench/run \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"backend_id": "statevector_sim", "workloads": ["bell_state"], "shots": 4096}'

{
  "benchmark_id": "1f0c…",
  "status": "queued",
  "estimated_time_seconds": 15,
  "message": "Benchmark queued for execution"
}

GET /api/v1/bench/report/{benchmark_id}

{
  "benchmark_id": "1f0c…",
  "status": "completed",
  "workloads": ["bell_state"],
  "backend_id": "statevector_sim",
  "completed_at": "2025-01-15T11:30:00Z",
  "metrics": {
    "state_fidelity": 0.9998,
    "hellinger_fidelity": 0.9997,
    "shots": 4096,
    "counts": {"00": 2048, "11": 2048}
  },
  "pass": true,
  "evidence_bundle_id": "evb_bell_x7y8z9",
  "integrity_state": "sealed_unsigned",
  "merkle_root": "sha256:3045022100..."
}

POST /bench/selftest

curl -X POST https://api.softquantus.com/bench/selftest \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"backend": "aws_ionq_aria_1"}'

{
  "backend": "aws_ionq_aria_1",
  "pass": true,
  "fidelity": 0.961,
  "latency_ms": 4800,
  "timestamp": "2025-01-15T11:35:00Z"
}

for b in statevector_sim aws_sv1 aws_ionq_aria_1; do
  curl -s -X POST https://api.softquantus.com/api/v1/bench/run \
    -H "Authorization: Bearer $QCOS_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"backend_id\": \"$b\", \"workloads\": [\"bell_state\"], \"shots\": 2048, \"seed\": 7}"
done

GET /bench/reports

# Get the sealed evidence bundle for an ACOS audit
curl -H "Authorization: Bearer $QCOS_API_KEY" \
  https://api.softquantus.com/bench/reports/{report_id}/bundle

import os
import time
import requests

API_KEY = os.environ["QCOS_API_KEY"]
BASE_URL = "https://api.softquantus.com"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

CANDIDATES = ["statevector_sim", "aws_sv1", "aws_ionq_aria_1"]

# Run the same Bell workload on every candidate with the same seed
benchmark_ids = {}
for backend_id in CANDIDATES:
    resp = requests.post(
        f"{BASE_URL}/api/v1/bench/run",
        headers=HEADERS,
        json={"backend_id": backend_id, "workloads": ["bell_state"], "shots": 2048, "seed": 7}
    )
    resp.raise_for_status()
    benchmark_ids[backend_id] = resp.json()["benchmark_id"]

# Poll each report until completed
reports = {}
for backend_id, bid in benchmark_ids.items():
    while True:
        r = requests.get(f"{BASE_URL}/api/v1/bench/report/{bid}", headers=HEADERS)
        if r.status_code == 200 and r.json().get("report"):
            reports[backend_id] = r.json()["report"]
            break
        time.sleep(5)

print("Backend Comparison — Bell Fidelity")
for backend_id, report in reports.items():
    print(backend_id, report)