AI 智能创建
SurveyKing v1.13.0 可以连接兼容 OpenAI Chat Completions API 的模型服务，根据自然语言生成问卷或考试内容。AI 是可选功能，不配置也不影响普通问卷、考试和投票功能。
准备模型服务
你需要：
- 一个兼容 OpenAI
/chat/completions接口的服务； - 该服务的 API Base URL；
- API Key；
- 至少一个可用的模型 ID；
- SurveyKing 服务器能够访问模型服务地址。
API Base URL 通常以 /v1 结尾，例如：
https://api.example.com/v1
SurveyKing 会在 Base URL 后调用 /chat/completions。如果供应商提供的是完整接口地址，也可以直接按其兼容说明填写。
模型名称必须使用供应商公布的模型 ID，不能只填写网页中显示的营销名称。
配置 AI
管理员登录后，进入“系统管理 → 系统设置 → AI 设置”。
| 配置项 | 说明 |
|---|---|
| 启用 AI | 关闭后，前台不会使用 AI 创建功能 |
| API Base URL | OpenAI 兼容服务的基础地址，通常以 /v1 结尾 |
| API Key | 模型服务的访问密钥；保存后不会回显完整密钥 |
| 模型列表 | 可用模型 ID，可配置多个供用户选择 |
| 默认模型 | 打开 AI 创建时默认使用的模型 |
| 系统提示词 | 可选；留空时使用 SurveyKing 内置提示词 |
编辑已有配置时，如果不需要更换密钥，可以把 API Key 留空，系统会保留原密钥。不要把真实 API Key 写进截图、日志、Git 仓库或公开问题中。
第一次 /setup 时也可以填写 AI 配置；暂时没有模型账号时直接跳过，之后再到系统设置中启用。
使用 AI 创建
- 新建项目，选择 AI 智能创建入口；
- 选择模型；
- 清楚描述主题、用途、题目数量、题型、目标人群和语言；
- 等待生成完成，检查题目和选项；
- 手工调整后再发布。
示例需求：
为新员工信息安全培训生成一份 10 题考试，包含 6 道单选、2 道多选和 2 道判断题；
每道题给出正确答案，难度中等，使用简体中文。
系统支持简体中文、繁体中文、英语、日语、韩语、德语、法语和泰语。AI 会结合当前系统语言要求输出，但最终结果仍取决于所选模型的语言能力。
AI 生成内容可能存在事实错误、重复题目或不合适的选项。发布前必须人工审核，特别是考试答案、医疗、法律、财务和隐私相关内容。
网络和隐私
发送 AI 请求时，提示词和必要的上下文会传给模型服务商。不要在提示词中提交身份证号、手机号、未公开商业数据或其他敏感信息；使用自建模型时，也要确认访问控制和日志策略。
如果 SurveyKing 部署在内网，而模型服务在公网，服务器需要具备出站 HTTPS 访问能力。浏览器能打开模型官网，不代表 Docker 容器或服务器也一定能访问 API。
常见问题
AI 入口没有显示
确认“启用 AI”已经打开，模型列表至少有一个有效模型，并重新登录或刷新页面。
返回 401 或 403
检查 API Key 是否有效、账号是否有余额或调用权限，以及 Base URL 是否属于同一个服务商。
返回 404
最常见原因是 Base URL 路径不正确。确认供应商是否兼容 OpenAI Chat Completions，以及最终路径是否为 /chat/completions。
一直等待或超时
在服务器或容器内检查到模型 API 的网络和 DNS。使用 Nginx 反向代理 SurveyKing 时，建议设置 proxy_buffering off 并增加 proxy_read_timeout。
模型无法使用
模型 ID 可能已经下线、无权限或拼写错误。以服务商控制台或接口文档返回的实际 ID 为准。