Quantum Bridge

Translates quantum circuits between frameworks and runs them on real hardware via the Quantum Bridge API at quantum-api.gpupulse.dev.

Setup

Requires an API key. Get one free (50 credits) at https://quantum-api.gpupulse.dev

Store the key:

# In your TOOLS.md or env
QUANTUM_BRIDGE_KEY=qb_...

API Reference

Base URL: https://quantum-api.gpupulse.dev/api/v1 Auth: Authorization: Bearer qb_... or X-API-Key: qb_...

Transpile QASM → OriginIR (1 credit)

curl -X POST "$BASE/transpile" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"qasm": "OPENQASM 2.0;\ninclude \"qelib1.inc\";\nqreg q[2];\ncreg c[2];\nh q[0];\ncx q[0],q[1];\nmeasure q[0] -> c[0];\nmeasure q[1] -> c[1];"}'

Response: {"originir": "QINIT 2\nCREG 2\nH q[0]\nCNOT q[0], q[1]\n...", "stats": {...}, "credits_charged": 1}

Reverse: OriginIR → QASM (1 credit)

curl -X POST "$BASE/reverse" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"originir": "QINIT 2\nCREG 2\nH q[0]\nCNOT q[0], q[1]"}'

Validate OriginIR (free)

curl -X POST "$BASE/validate" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"originir": "QINIT 2\nH q[0]\nCNOT q[0], q[1]"}'

IBC Consensus (2 credits)

Multi-agent quantum consensus. Each agent has a name and feature vector.

curl -X POST "$BASE/consensus" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"agents": [
    {"name": "Scheduler", "features": [0.9, 0.1, 0.3]},
    {"name": "Optimizer", "features": [0.1, 0.9, 0.2]},
    {"name": "Monitor",   "features": [0.7, 0.3, 0.5]}
  ], "threshold": 0.3}'

Response includes consensus groups, conflicts, similarity matrix, and quantum timing.

Submit Circuit to Hardware (5-10 credits)

Submit to cloud simulator (5 credits) or real Wukong 72-qubit chip (10 credits).

curl -X POST "$BASE/submit" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"qasm": "OPENQASM 2.0;...", "backend": "wukong", "shots": 1000}'

Response: {"task_id": "task_...", "status": "queued", "poll_url": "/api/v1/submit/task_..."}

Poll for results:

curl "$BASE/submit/task_..." -H "Authorization: Bearer $KEY"

Check Balance (free)

curl "$BASE/balance" -H "Authorization: Bearer $KEY"

List Backends (free with auth)

curl "$BASE/backends" -H "Authorization: Bearer $KEY"

Supported Gates (no auth)

curl "$BASE/gates"

Supported Gates

20+ mappings: H, X, Y, Z, S, T, I, RX, RY, RZ, U2, U3, CNOT, CZ, SWAP, CR, Toffoli, CSWAP, DAGGER blocks, BARRIER, MEASURE.

Usage Patterns

Transpile for a user:

1. Take their QASM input
2. POST to /transpile
3. Return the OriginIR and stats