4つの API を、ひとつのパッケージで
NPC の判断・勝率予測・難易度調整・結果の較正。自作すると一番重い部分を、HTTP で呼ぶだけにします。登録すると4つがまとめて有効になり、使わないものはダッシュボードで1本ずつオフにできます。
確率分布で返る次の一手
盤面テキストと合法手を送ると、次の行動と候補手の確率分布が返ります。難易度 0〜1 の連続値で、同じ盤面でも手加減の度合いが滑らかに変わります。
較正済みの勝率予測
「このプレイヤーはこの敵に勝てるか」を確率で返します。対戦結果を返送するたびに較正され、予測品質は Brier スコアで測れます。
目標成功率への自動調整
「勝率65%にしたい」と目標を渡すと、敵の強さや難易度パラメータの次の値を推薦します。目標はあなたのゲームが決め、サーバは固定しません。
結果を返すほど、予測が育つ
対戦結果を送ると、勝率予測の較正（Brier スコア）とプレイヤーのレーティングが更新されます。predict と adjust があなたのゲームに合っていくのはこのおかげです。
説明より、体験
2つのミニゲームが実際の API を叩いています。スライダーを動かすと CPU の挙動が変わります。
料金
decide 1リクエスト = 1判定。クレジットカード不要で Free から始められます。
登録すると Gunshi パッケージの4つの API がまとめて有効になります。キー・利用量・プランは 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 を叩いています。