3つのAPIで、CPU戦のすべてを
NPCのAI・勝率予測・難易度調整。自作すると一番重い3つを、HTTPで呼ぶだけにします。
POST /v1/decide
確率分布で返る次の一手
盤面テキストと合法手を送ると、次の行動と候補手の確率分布が返ります。難易度 0〜1 の連続値で、同じ盤面でも手加減の度合いが滑らかに変わります。
POST /v1/predict
較正済みの勝率予測
「このプレイヤーはこの敵に勝てるか」を確率で返します。対戦結果を返送するたびに較正され、予測品質は Brier スコアで測れます。
POST /v1/adjust
目標成功率への自動調整
「勝率65%にしたい」と目標を渡すと、敵の強さや難易度パラメータの次の値を推薦します。目標はあなたのゲームが決め、サーバは固定しません。
説明より、体験
2つのミニゲームが実際の API を叩いています。スライダーを動かすと CPU の挙動が変わります。
料金
decide 1リクエスト = 1判定。クレジットカード不要で Free から始められます。
mathru.net の共通アカウントでキーを発行し、ダッシュボードで利用量とプランを管理します。
API はこれだけ
中核は4エンドポイント。盤面はテキスト、合法手は文字列の配列。エンジン統合もSDKも不要です。
# 次の一手（+ 確率分布） curl -X POST https://api.mathru.net/gunshi/v1/decide \ -H "Authorization: Bearer $KEY" \ -d '{"game_id":"my-game","state":"Turn 3. CPU Hibachi HP 52/78 ...", "legal_actions":["use Ember","use Tackle"],"difficulty":0.55}' # 勝率予測（較正済み） curl -X POST https://api.mathru.net/gunshi/v1/predict \ -d '{"player":{"id":"p1","atk":14},"opponent":{"id":"floor-3","power":6.5}, "statement":"The player defeats this floor."}' # 結果の返送（較正と Brier スコア） curl -X POST https://api.mathru.net/gunshi/v1/sessions/outcome \ -d '{"session_id":"...","won":true,"predicted_p_win":0.62,"difficulty":0.55}' # 目標成功率への難易度調整 curl -X POST https://api.mathru.net/gunshi/v1/adjust \ -d '{"target_p_win":0.65,"current":{"difficulty":0.55,"enemy_power":6.5}, "knobs":{"min_enemy_power":2,"max_enemy_power":20}}'
デモキーで今すぐ試せます
登録不要。下のデモは本物の API を叩いています。