Python調用requests庫實現(xiàn)自動化發(fā)牌功能

更新時間：2025年07月03日 09:35:38 作者：東方佑

在游戲開發(fā)或自動化測試中,快速生成隨機撲克牌是一個常見需求,本文將使用Python中的requests庫實現(xiàn)自動化發(fā)牌功能,有需要的小伙伴可以參考一下

背景介紹

在游戲開發(fā)或自動化測試中，快速生成隨機撲克牌是一個常見需求。本文通過 Python 的 requests 庫，向本地部署的大模型接口發(fā)送 HTTP 請求，實現(xiàn)自動化發(fā)牌功能。代碼簡潔高效，適合初學者快速上手。

核心代碼解析

以下代碼展示了如何通過 POST 請求調用本地模型接口生成 5 張撲克牌：

import requests

# 配置目標地址和請求頭
url = "http://localhost:1234/v1/chat/completions"
headers = {
    "Content-Type": "application/json"
}

# 定義請求體數(shù)據(jù)
data = {
  "stream": False,
  "detail": False,
  "model": "qwen3-0.6b",
  "tool_choice": "auto",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_poker_cards",
        "description": "生成指定數(shù)量的撲克牌",
        "parameters": {
          "type": "object",
          "properties": {
            "num": {
              "type": "integer",
              "description": "需要生成的撲克牌數(shù)量",
              "minimum": 1,
              "maximum": 52
            }
          },
          "required": ["num"]
        }
      }
    }
  ],
  "messages": [
    {
      "role": "system",
      "content": "你是一個專業(yè)的發(fā)牌助手，必須使用get_poker_cards工具來處理發(fā)牌請求"
    },
    {
      "role": "user",
      "content": "請發(fā)5張牌"
    }
  ]
}

# 發(fā)送請求并打印結果
response = requests.post(url, headers=headers, json=data)
print("Status Code:", response.status_code)
print("Response Body:", response.text)

代碼詳解

1.接口配置

url: 本地模型服務的 API 地址（需提前部署）。
headers: 指定請求內(nèi)容類型為 JSON。

2.請求體參數(shù)

tools: 定義可用工具 get_poker_cards，限制生成牌數(shù)范圍為 1~52。
messages: 模擬用戶對話，系統(tǒng)提示強制使用工具處理發(fā)牌請求。

3.發(fā)送請求

使用 requests.post() 發(fā)送 POST 請求，傳遞 JSON 格式的數(shù)據(jù)。
打印響應狀態(tài)碼和結果（如生成的牌面信息）。

運行結果示例

假設接口正常返回，輸出可能如下：

Status Code: 200
Response Body: {"cards": ["♠?8", "♥?Q", "♦?3", "♣?A", "♠?2"]}

擴展應用

1.動態(tài)調整牌數(shù)

修改 data["messages"][1]["content"] 中的數(shù)字即可生成任意數(shù)量的牌（1~52）。

2.集成到游戲框架

將此代碼封裝為函數(shù)，作為游戲初始化模塊的一部分，實現(xiàn)自動洗牌、發(fā)牌流程。

3.錯誤處理優(yōu)化

增加異常捕獲邏輯，應對網(wǎng)絡中斷或接口異常：

try:
    response = requests.post(url, headers=headers, json=data, timeout=5)
    response.raise_for_status()  # 拋出 HTTP 錯誤
except requests.exceptions.RequestException as e:
    print("請求失敗:", e)