概述
将客户端接入云端大模型时，通常需要三类信息：接口地址（或 Base URL + 路径）、访问密钥、模型 ID。不同产品界面字段名称可能不同，但含义一致。请仅在客户端「大模型 / API / 智能对话」等对应配置项中填写，勿与其他业务配置混用。
建议在正式环境使用前，先用「测试连接」或单次对话请求验证配置有效，再保存并投入批量使用。
推荐配置（硅基流动 SiliconFlow）
对多数国内网络环境，硅基流动提供 OpenAI 兼容接口，适合作为默认选项。下表为常见填法，若您的软件仅提供「Base URL」输入框，请使用第二行。
| 配置项 | 建议值 | 说明 |
|---|---|---|
| 完整 API URL | https://api.siliconflow.cn/v1/chat/completions |
须包含路径 /v1/chat/completions，勿截断 |
| Base URL（分栏填写时） | https://api.siliconflow.cn/v1 |
由程序自动补全 chat/completions 时使用 |
| API Key | 控制台生成的密钥 | Bearer 方式；勿泄露、勿提交至公开代码库 |
| Model | 以控制台「模型」列表为准 | 例：带前缀的完整模型 ID，随平台产品迭代可能变更 |
主流服务商参考
以下供横向对比，实际以各服务商当时公示的端点、模型名与合约为准。
| 服务商 | 典型接口 / Base | 说明 |
|---|---|---|
| 硅基流动 | https://api.siliconflow.cn/v1/... 或 api.siliconflow.com 区域 |
多模型接入；高负载时可能返回 5xx 或限流，可稍后重试 常用 |
| DeepSeek | https://api.deepseek.com（以官方文档为准） |
见 api-docs.deepseek.com |
| 阿里通义 DashScope | 如 ...aliyuncs.com/compatible-mode/v1，地域与账号一致 |
中国站与国际站端点不同，请按开通地域选择 |
| 其他 | 以厂商控制台「API 文档 / 示例」为准 | 鉴权、路径与通义/硅基类可能不同，请复制官方示例 |
若客户端提示「模型不存在」或
404，多为模型 ID 已调整或当前账号未开通该模型，请在服务商控制台重新选择并复制有效模型名。标准操作步骤
1. 注册与开通
- 访问所选服务商官网，完成企业或个人账号注册，并按指引完成实名与计费方式（如适用）。
- 在控制台的「API 密钥 / API Key」中创建新密钥，并安全保存。多数平台仅展示一次完整密钥。
2. 在客户端中填写
- 打开软件内的「大模型、API、模型服务」等配置页。
- 将服务商文档中的 端点、密钥、模型 分别填入对应字段，避免在 URL 前后增加空格或多余引号。
- 先执行「测试」或发送一条极简对话，确认成功后再长期保存配置。
验证与测试
- 使用产品自带的「测试连接」或等效功能。
- 发送简短请求（如一句问候）确认可返回正常文本响应。
- 若失败，请核对密钥有效期、账户余额/配额、以及模型在控制台是否仍为可用状态。
常见 HTTP 状态与处理
| 状态 | 含义 | 建议 |
|---|---|---|
| 400 | 请求参数或格式不符合要求 | 检查 URL 是否完整、模型名是否与控制台一致 |
| 401 | 鉴权失败 | 更换或重新创建 API Key，确认未过期、未复制错误 |
| 402/403 | 余额不足或无权限 | 查看账单与模型开通情况 |
| 404 | 资源不存在 | 核对端点路径与模型 ID 是否为当前环境有效值 |
| 429 | 请求过于频繁 | 降低并发或稍后重试，必要时联系服务商提额 |
| 500/503/504 | 服务商侧异常或拥堵 | 等待恢复或错峰使用；可订阅服务商状态通知 |
安全与合规建议
密钥管理
密钥与密码同级；禁止硬编码在公开仓库。泄露后立即在控制台撤销并轮换。
权限与审计
按项目或环境拆分密钥，定期审查调用量与费用，发现异常及时停用。
常见问题
软件里没有「URL」或只有「基础地址」怎么办？
以软件说明书为准：有的产品拆分为 Base URL 与 Path，有的合并为一行。可联系软件提供方获取针对该界面的填法说明。
配置曾可用，后来报错？
可能为服务商更新模型 ID、调整计费或密钥被轮换。请登录服务商控制台重新核对并更新客户端配置。
应选用 .com 还是 .cn 域名？
以您账号所在区域及服务商当前文档中的「可用域名为准」。网络策略导致无法连接时，可尝试文档列出的其他区域或线路。
参考链接（官方文档）
下列链接便于自行核对；若与客户端内嵌说明冲突，以服务商网站最新版本为准。
- 硅基流动 — Chat Completions 接口：docs.siliconflow.com
- 硅基流动 — 示例端点（Readme）：api.siliconflow.cn /v1/chat/completions
- DeepSeek — API 文档：api-docs.deepseek.com
- 阿里云 — OpenAI 兼容模式（通义/DashScope）：Alibaba Cloud 帮助文档
文档版本说明：供配置参考；服务商接口与模型列表会持续更新。更新日期：2026-04-25。