アプリから、量子コンピュータへ。 From your app to a quantum computer.

QUBOを組み立てるBuild the QUBO

各項は coeff × q_i × q_j × … を表します。例: 三角形グラフのMaxCutは、各辺 (i, j) について −q_i − q_j + 2q_iq_j を足し合わせます。 Each term contributes coeff × q_i × q_j × …. Example: MaxCut on a triangle sums −q_i − q_j + 2q_iq_j over each edge (i, j).

POST /v1/qaoa/run を呼び出すCall POST /v1/qaoa/run

{"qubo": [
  {"coeff": -2, "qubits": [0]}, {"coeff": -2, "qubits": [1]}, {"coeff": -2, "qubits": [2]},
  {"coeff": 2, "qubits": [0,1]}, {"coeff": 2, "qubits": [1,2]}, {"coeff": 2, "qubits": [0,2]}
], "steps": 2, "shots": 256}

ソート済みの解を受け取るGet back sorted solutions

目的関数値の小さい順に並んだ解（q0起点のビット列・各ビットの値・目的関数値・出現回数）と、最適化されたQAOAパラメータが返ります。 Solutions come back sorted by objective value — each with a q0-first bitstring, its bits, its objective value, and its sample count — plus the optimized QAOA parameters.

{"best": {"bitstring": "101", "bits": [1,0,1], "value": -2.0, "count": 45}, ...}

トークンを取得Get a token

https://mcp.blueqat.app/login にアクセスし、blueqatアカウントでログインします。約2時間有効なアクセストークンが発行されます（MCPサーバーと共通です）。サーバー間連携やスクリプトには、アカウントページで発行できる有効期限のないAPIキーが便利です。 Visit https://mcp.blueqat.app/login and sign in with your blueqat account. You'll get back an access token good for about 2 hours (the same token works on the MCP server). For server-to-server use or scripts, issue a no-expiry API key from your account page instead.

リクエストを送るMake a request

トークンを Authorization ヘッダーに付けて呼び出します: Call it with the token in the Authorization header:

curl -X POST https://qapi.blueqat.app/v1/circuits/run \
  -H "Authorization: Bearer <your token>" \
  -H "Content-Type: application/json" \
  -d '{"n_qubits":2,"gates":[{"gate":"h","qubits":[0]},{"gate":"cx","qubits":[0,1]}],"shots":200}'

スキーマを確認Explore the schema

Swagger UIで全エンドポイントのリクエスト/レスポンス形式を確認できます。 The Swagger UI documents the request/response shape for every endpoint.