🔌 麻邻国 AI API

全球首个商用级棋牌AI推理API — 覆盖9种主流玩法，毫秒级响应

快速开始

1. 获取 API Key

注册麻邻国会员后，在控制台获取你的 API Key。免费额度：100次/天。

2. 发送第一个请求

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.malinguo.com/v1"

resp = requests.post(f"{BASE_URL}/predict", json={
    "game": "sichuan",
    "hand": ["1m","2m","3m","4p","5p","6p","7s","8s","9s","1z","1z","2z","3z"],
    "discards": [],
    "dora": ["5m"],
    "seat_wind": "E",
    "round_wind": "E"
}, headers={"Authorization": f"Bearer {API_KEY}"})

data = resp.json()
print(f"推荐打: {data['best_tile']}")
print(f"置信度: {data['confidence']:.1%}")
print(f"胜率:   {data['win_rate']:.1%}")

curl -X POST https://api.malinguo.com/v1/predict \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "game": "sichuan",
    "hand": ["1m","2m","3m","4p","5p","6p","7s","8s","9s","1z","1z","2z","3z"],
    "discards": [],
    "dora": ["5m"],
    "seat_wind": "E",
    "round_wind": "E"
  }'

const resp = await fetch("https://api.malinguo.com/v1/predict", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    game: "sichuan",
    hand: ["1m","2m","3m","4p","5p","6p","7s","8s","9s","1z","1z","2z","3z"],
    discards: [],
    dora: ["5m"],
    seat_wind: "E",
    round_wind: "E"
  })
});

const data = await resp.json();
console.log(`推荐打: ${data.best_tile}, 置信度: ${data.confidence}`);

3. 响应示例

{
  "best_tile": "3z",
  "confidence": 0.87,
  "win_rate": 0.42,
  "alternatives": [
    {"tile": "2z", "probability": 0.09},
    {"tile": "1z", "probability": 0.03}
  ],
  "explanation": "3z是孤立字牌，与手牌无搭子关系。手牌主力为万子和筒子，优先清理字牌。",
  "tags": ["孤张", "效率"],
  "shanten": 1,
  "latency_ms": 12
}

API 参考

POST /v1/predict

根据当前手牌状态，返回AI推荐的最佳出牌。

POST /v1/evaluate

评估指定模型在给定对手下的胜率。

GET /v1/models

返回所有可用模型及其最新胜率指标。

{
  "models": [
    {
      "game": "changsha",
      "version": "evo-gen3",
      "vs_random": 0.43,
      "vs_greedy": 0.20,
      "updated_at": "2026-03-16"
    },
    ...
  ]
}

POST /v1/explain

对指定出牌生成策略解释文本（中文）。

牌面编码

错误码

SDK (Python)

# pip install malinguo
from malinguo import MalinguoClient

client = MalinguoClient(api_key="your_key")

# 推荐出牌
advice = client.predict(
    game="sichuan",
    hand=["1m","2m","3m","4p","5p","6p","7s","8s","9s","1z","1z","2z","3z"],
    missing_suit="s"
)
print(advice.best_tile)       # "3z"
print(advice.confidence)      # 0.87
print(advice.explanation)     # "3z是孤立字牌..."
print(advice.alternatives)    # [{"tile":"2z","probability":0.09}, ...]

# 查看所有模型
models = client.list_models()
for m in models:
    print(f"{m.game}: vs_random={m.vs_random:.0%}")

定价

支持的玩法

© 2026 麻邻国 AI · 首页 · AI教练 · dev@malinguo.com