{"product":"玩吗 - 桌游DM","endpoint":"/api/chat","title":"桌游推荐与规则问答接口","description":"面向桌游推荐、规则解释和裁判追问的聊天接口。POST 使用 JSON 请求体，GET 返回接口说明。","allowed_methods":["GET","POST","OPTIONS"],"request_content_type":"application/json","required_fields":["messages"],"optional_fields":{"task":"可选，推荐的任务类型：recommend_game、explain_rules、referee_followup。","model":"可选，上游模型名称；默认使用服务端配置或默认值。","max_tokens":"可选，最大输出 token 数，默认 1000。","temperature":"可选，采样温度；推荐推荐模式 0.7、规则问答更低。","stream":"可选，是否使用上游 SSE 流式输出。为 true 时，接口透传 text/event-stream。","providerBaseUrl":"可选，上游兼容 OpenAI chat completions 的 base URL。","userApiKey":"可选，自带上游 API key；若服务端已配置则可省略。"},"capabilities":["根据人数、时长、氛围推荐桌游","解释规则、胜利条件、平局和常见问题","支持持续追问，适合作为桌游 DM / 裁判助手"],"limitations":["当前接口不公开创建账号、写入用户偏好或持久化会话状态。","当前没有公开的 OAuth、service account 或 API key 管理页。","返回结果为上游聊天补全格式透传，字段可能随模型提供方略有差异。"],"notes":["若只想先了解怎么调用，直接 GET /api/chat 即可获得机器可读说明。","更多站点说明见 /developers/，结构化 schema 见 /openapi.json。"],"authentication":"公开服务端接口；当前没有公开的 API key 发放页或 service account。","statefulness":"接口本身无状态。若需要持续对话，调用方应自行携带完整 messages 历史。","recommended_tasks":[{"id":"recommend_game","title":"桌游推荐","description":"根据人数、时长、氛围和场景推荐合适桌游。","examplePrompt":"推荐一个适合 4 人破冰、30 分钟内能讲完规则的桌游"},{"id":"explain_rules","title":"规则解释","description":"解释某个桌游的规则、胜利条件、平局处理和常见问题。","examplePrompt":"德国心脏病怎么赢？"},{"id":"referee_followup","title":"裁判追问","description":"围绕一局正在进行的游戏继续追问特定细节。","examplePrompt":"如果两个人同时拍牌，德国心脏病怎么算？"}],"example_request":{"task":"recommend_game","messages":[{"role":"user","content":"推荐一个适合 4 人破冰、30 分钟内能讲完规则的桌游"}],"temperature":0.7,"max_tokens":800},"example_response":{"choices":[{"message":{"role":"assistant","content":"可以试试《德国心脏病》或《机密代号》，都很适合 4 人破冰。"}}]},"docs_url":"/developers/","openapi_url":"/openapi.json","llms_url":"/llms.txt","capabilities_url":"/capabilities.json","last_updated":"2026-03-24"}