模型接入 / DeepSeek

DeepSeek 模型接入

所有模型系列共用同一套 OpenAI 兼容接入流程；切换后只需关注当前模型提示。

OpenAI 兼容

切换模型系列：DeepSeek

Qwen DeepSeek GLM Kimi MiniMax 腾讯混元

通用接入信息橙域 API Key · OpenAI Base URL · Model ID

查看环境变量配置 →

01 查询模型 ID

模型清单由当前 API Key 的分组授权决定，先执行 GET /v1/models：

GET /v1/models

curl "${XELFORA_OPENAI_BASE_URL}/models" \
  -H "Authorization: Bearer ${XELFORA_API_KEY}"

只复制返回结果中的准确 id 并保存为 XELFORA_MODEL。没有对应条目时，请联系管理员，不要猜型号。

02 发送第一次调用

把返回的模型 ID 保存为 XELFORA_MODEL，再选择语言复制示例。

curl "${XELFORA_OPENAI_BASE_URL}/chat/completions" \
  -H "Authorization: Bearer ${XELFORA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "${XELFORA_MODEL}",
  "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己。"}],
  "stream": false
}'

普通文本使用 POST /v1/chat/completions。流式、工具调用、视觉和推理能力请按实际 Model ID 单独验证。

DeepSeek 使用提示

面向 DeepSeek 模型类别的 OpenAI 兼容入口，可沿用既有 Chat Completions 调用结构。

模型 ID 不能从模型族名称推断，以 GET /v1/models 返回为准。
推理模式和输出限制随具体模型与路由配置变化。

遇到 401、403、429 或模型不可用？查看通用错误处理 →