连接 AI 服务商
选择 OpenAI、DeepSeek 或兼容 OpenAI 的端点，填写 API key 和模型，保存并测试连接，然后监控 token、成本和最近的 AI 调用。
AI Provider 有什么用？#
LDPage 的所有 AI 功能（AI 生成页面、编辑器中的 AI Agent、内容改写、SEO 等）都调用同一个由全部客户共享的 AI 服务商。您只需在 管理 › 设置 › AI Provider（集成分组）中配置一次。客户看不到 API key；客户每次使用 AI，都会按 token 数扣除其套餐中的 AI 点数（1 点 ≈ 1.000 token）。
1. 选择服务商、端点和 API key#
- 1
打开账户菜单 › SaaS 管理 › 设置，在左侧“集成”分组中选择 AI Provider。
- 2
在“连接 AI”（Kết nối AI）卡片中选择 Provider：OpenAI、DeepSeek 或 OpenAI-compatible（自定义）。选择 OpenAI 或 DeepSeek 时会自动填入 Endpoint（https://api.openai.com/v1 或 https://api.deepseek.com）。
- 3
OpenAI-compatible 适用于提供 OpenAI 风格 API 的服务器，如 Ollama、vLLM、OpenRouter 等：自行填写 Endpoint（API 根地址），若端点无需 key 可将 API key 留空。
- 4
填写 API key。密钥会加密保存在您的服务器上；保存后输入框显示 ••••••••（已保存 — 输入以替换），留空即保留原 key。“获取 API key”链接会打开所选服务商的密钥页面。
- 5
若切换到与已保存配置不同的服务商，旧 key 无法使用：表单会提示已保存的 key 属于之前的服务商，并要求输入新 key。
2. 选择模型、单价和超时#
- 1
文本模型（Model văn bản）：输入模型名称或点击下方建议标签（OpenAI：gpt-4o-mini、gpt-4o、gpt-4.1-mini、gpt-4.1；DeepSeek：deepseek-flash、deepseek-v4-pro）。大多数任务使用此模型。
- 2
AI Agent 模型（可选）：用于 AI Agent 重型任务（如代码模式、改写多个部分）的更强模型。留空 = 使用文本模型；轻量任务仍用文本模型以保持快速、低成本。
- 3
单价（USD/1M token）：按服务商价格表填写输入和输出单价，以便 LDPage 估算成本（AI Agent 显示每次运行的估算成本，概览页显示本月 AI 成本）。留空 = 不估算成本。
- 4
超时：单次 AI 调用的最长等待秒数（5–600 秒，默认 120）。如果模型较慢或长页面经常超时，可调大此值。
3. 先保存配置，再测试连接#
- 1
点击“连接 AI”卡片底部的保存配置（Lưu cấu hình）。
- 2
点击测试连接（Kiểm tra kết nối）。LDPage 会使用“已保存”的配置向服务商发送一个小请求，因此请先保存再测试；否则结果反映的是旧配置。
- 3
右侧连接状态卡片显示已配置、未配置或连接错误（附错误信息）；副标题显示服务商、配置来源（database 或环境变量）和模型。每次测试后会更新响应时间和最近检查时间。
- 4
连接成功后，用 AI 生成一个页面，确认整个流程正常。
4. 监控用量与成本#
- 1
“AI 使用情况”卡片累计全系统的 Prompt tokens、Completion tokens 和估算成本。此卡片仅用于运营监控；每位客户的限制由套餐限额决定。
- 2
“最近活动”表列出最新的 AI 调用：时间、操作（如 template_agent.plan、template_agent.copy_section）、模型、Tokens (in/out) 和延迟。
- 3
只有填写单价后才会有估算成本；如果始终为 $0.0000，请检查输入和输出两个字段。
- 4
要查看哪些客户 AI 成本最高，请使用 管理 › 概览 中的本月 AI 成本最高客户表；如需限制用量，请在服务套餐中调整 AI 次数/月和 AI 点数/月。
5. 通过环境变量配置 AI#
当服务器设置了 AI_BASE_URL 和 AI_TEXT_MODEL（以及 AI_API_KEY，可选 AI_PROVIDER、AI_AGENT_MODEL、AI_TIMEOUT_MS）时，环境变量优先于页面配置：AI Provider 页面会提示服务商通过环境变量配置，连接状态显示来源为环境变量。如需在页面上管理，请在 .env 中将 AI_BASE_URL 和 AI_TEXT_MODEL 留空并重启 API。
常见问题#
- 1
测试提示尚未配置 AI provider：尚未点击保存配置，或 Endpoint/模型为空。
- 2
认证错误：API key 错误、已过期或属于其他服务商；请重新输入并保存。
- 3
超时错误：调大超时，检查服务器能否通过互联网访问 Endpoint，或改用更快的模型。
- 4
页面上的修改不生效：检查服务器上的 AI_BASE_URL/AI_TEXT_MODEL 环境变量（环境变量优先）。
- 5
客户反映 AI 点数用完：查看其套餐的 AI 点数/月限额，或在 管理 › 客户 中为其分配更高套餐。