模型选择与能力对照
DeepSeek 模型适合通用文本、代码、复杂推理和批量抽取。实际可用模型以 Xikapi 后台模型列表为准。
新手先确认
DeepSeek 在 Xikapi 中通常按 OpenAI 兼容 Chat Completions 调用。先用 deepseek-v4.5-chat 这类通用模型跑通基础请求，再切换到推理或高能力模型。
| 要确认的内容 | 正确做法 | 常见误区 |
|---|---|---|
| Base URL | SDK 填 https://xikapi.com/v1 | 填成完整 /chat/completions |
| API Key | 使用 Xikapi API Key | 使用 DeepSeek 官方 Key 调 Xikapi 地址 |
| 模型名 | 以 Xikapi 后台启用名称为准 | 复制旧别名后后台未开放 |
| 推理模型 | 设置更长超时和输出上限 | 用短超时测试后误判失败 |
| 结构化输出 | 低温度 + JSON 校验或结构化能力 | 只在提示词里写“返回 JSON” |
常见模型
| 模型 | 适合场景 | 说明 |
|---|---|---|
deepseek-v4.5-chat | 日常聊天、写作、总结、抽取 | 当前推荐通用模型 |
deepseek-v4.5-reasoner | 复杂推理、数学、代码难题 | 当前推荐高能力模型 |
deepseek-chat | 旧兼容名称 | 官方标注将于 2026-07-24 停用 |
deepseek-reasoner | 旧兼容名称 | 官方标注将于 2026-07-24 停用 |
按场景选择
| 场景 | 推荐模型 | 说明 |
|---|---|---|
| 普通聊天 | deepseek-v4.5-chat | 成本和速度均衡 |
| 批量分类 | deepseek-v4.5-chat | 适合低温度、短输出 |
| 复杂推理 | deepseek-v4.5-reasoner | 适合多步骤分析 |
| 代码分析 | deepseek-v4.5-reasoner / deepseek-v4.5-chat | 视任务复杂度选择 |
| 结构化抽取 | deepseek-v4.5-chat | 配合 JSON 校验 |
后台字段建议
| 字段 | 建议值 |
|---|---|
| 供应商 | DeepSeek |
| 模型类型 | 文本、推理、代码、工具调用 |
| 标签 | 低成本、强推理、代码、中文优化、结构化输出 |
| 可用令牌分组 | 默认开放通用模型，高级分组开放推理模型 |
| 计费类型 | 通常按输入和输出 token 计费 |
推荐接入策略
- 通用任务使用
deepseek-v4.5-chat - 复杂推理任务使用
deepseek-v4.5-reasoner - 旧模型名只作为兼容别名处理，生产配置应尽快迁移
- 推理模型输出可能更长，要控制最大输出长度
- 高成本模型放入受控令牌分组
常见排错
| 现象 | 优先检查 |
|---|---|
401 | Xikapi Key 是否正确，Header 是否为 Authorization: Bearer ... |
404 | Base URL 是否写到 /v1，不要重复拼 /chat/completions |
model not found | 模型是否已在 Xikapi 后台启用，旧别名是否仍可用 |
| 输出很慢 | 是否使用推理模型，是否需要提高超时或降低最大输出长度 |
| JSON 解析失败 | 是否设置低温度、结构化输出或后置 JSON 校验 |
| 成本异常 | 是否把复杂任务误发到高能力模型，是否缺少用户分组限制 |