Skip to main content

QCOS API v2.1 - Overview

What's New in v2.1​

QCOS API v2.1 introduces Multi-Supplier Support, providing unified access to quantum cloud providers worldwide through a single API.

Supported Suppliers​

SupplierProvidersTotal QubitsFeatures
Azure QuantumIonQ, Rigetti, Quantinuum, PASQALUp to 100All-to-all connectivity, highest fidelity
IBM QuantumIBM Simulators, IBM QPUsUp to 127Open access, mature ecosystem
AWS BraketAmazon, IonQ, Rigetti, OQC, IQM, QuEraUp to 256Largest qubit count, neutral atoms

Total Capacity​

  • 17+ quantum providers across 3 major cloud platforms
  • 20+ quantum backends including simulators and QPUs
  • Up to 256 qubits on QuEra Aquila neutral atom system
  • Multiple architectures: trapped ions, superconducting, neutral atoms

Architecture​

┌─────────────┐
│   Your App  │
└──────┬──────┘
       │
       │ QCOS SDK/API
       │
┌──────▼──────────────────────────┐
│     QCOS API Gateway v2.1       │
│  (Unified Multi-Supplier API)   │
└──┬────────────┬────────────┬────┘
   │            │            │
   │ Azure      │ IBM        │ AWS
   │ Quantum    │ Quantum    │ Braket
   │            │            │
┌──▼────┐  ┌───▼────┐  ┌────▼───┐
│ IonQ  │  │  IBM   │  │ QuEra  │
│Rigetti│  │  QPUs  │  │ IonQ   │
│Quant. │  │ Sim.   │  │Rigetti │
│PASQAL │  │        │  │ Sims   │
└───────┘  └────────┘  └────────┘

Key Features​

1. Unified API​

Single API for all quantum cloud providers:

from softqcos_sdk import QCOSClient

client = QCOSClient(api_key="your-key")

# Same interface for all suppliers
azure_result = client.execute_on_backend(qasm, "ionq.simulator", "azure_quantum")
ibm_result = client.execute_on_backend(qasm, "ibm_kyoto", "ibm_quantum")
braket_result = client.execute_on_backend(qasm, "Aquila", "braket")

2. Automatic Failover​

Built-in fallback strategy across suppliers:

suppliers = [
    ("azure_quantum", "ionq.simulator"),
    ("ibm_quantum", "ibm_simulator"),
    ("braket", "sv1")
]

for supplier, backend in suppliers:
    try:
        result = client.execute_on_backend(qasm, backend, supplier)
        break  # Success!
    except Exception:
        continue  # Try next supplier

3. Cost Optimization​

Compare costs across providers before execution:

# Get cost estimates from all suppliers
azure_cost = client.estimate_cost(qasm, "ionq.aria", "azure_quantum")
ibm_cost = client.estimate_cost(qasm, "ibm_kyoto", "ibm_quantum")
braket_cost = client.estimate_cost(qasm, "IonQ Aria", "braket")

# Choose cheapest option
best = min([azure_cost, ibm_cost, braket_cost], key=lambda x: x.total_usd)

4. Provider Discovery​

Dynamic discovery of available backends:

# List all available providers
all_providers = {
    "Azure Quantum": client.list_providers("azure_quantum"),
    "IBM Quantum": client.list_providers("ibm_quantum"),
    "AWS Braket": client.list_providers("braket")
}

# Filter by qubit count
large_backends = [
    p for providers in all_providers.values()
    for p in providers
    if p.num_qubits >= 100
]

Use Cases​

Research & Development​

  • Algorithm Testing: Test algorithms across different quantum architectures
  • Benchmarking: Compare performance across providers
  • Prototyping: Rapid iteration with simulator access

Production Workloads​

  • High Availability: Automatic failover ensures uptime
  • Cost Optimization: Select cheapest provider for each job
  • Scalability: Handle variable loads across multiple backends

Education​

  • Multi-Platform Access: Learn different quantum systems
  • Cost-Effective: Use free simulators for learning
  • Real Hardware: Access to actual QPUs for advanced students

Getting Started​

1. Install SDK​

pip install softqcos-sdk

2. Get API Key​

Sign up at portal.softquantus.com to get your API key.

3. Run Your First Circuit​

from softqcos_sdk import QCOSClient

client = QCOSClient(api_key="your-api-key")

# Bell state circuit
qasm = """
OPENQASM 2.0;
include "qelib1.inc";
qreg q[2];
creg c[2];
h q[0];
cx q[0],q[1];
measure q -> c;
"""

# Execute on Azure Quantum
result = client.execute_on_backend(
    qasm=qasm,
    backend="ionq.simulator",
    supplier="azure_quantum",
    shots=1024
)

print(result.counts)

Next Steps​

Pricing​

QCOS API charges a small markup on top of provider costs:

  • Simulators: $0.001 per job + provider costs
  • QPUs: 5% markup on provider costs
  • Free Tier: 100 simulator jobs/month

See Pricing Guide for detailed information.

Support​