全部教程 /
在 Dify 中使用 XHuoAPI
Dify 的 OpenAI-API-compatible 供应商是按模型逐个配置的：每加一个模型填一次端点和密钥。
开始之前
先验证一下
curl https://api.xhuoapi.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'
配置步骤
1
右上角头像 → 设置 → 模型供应商，找到 OpenAI-API-compatible，点添加模型。
2
填写：模型类型 LLM、模型名称、API Key、API endpoint URL，以及上下文长度和最大输出。
Model Name: deepseek-v4-pro API endpoint URL: https://api.xhuoapi.ai/v1 API Key: sk-...
3
保存时 Dify 会发一次校验请求。通过后模型就出现在应用编排的模型下拉里。
注意事项
已知问题：OpenAI-API-compatible 供应商固定发送 max_tokens 参数，而 gpt-5.x 系列要求 max_completion_tokens，校验会报 400。要用 gpt-5.x 时，改用 Dify 内置的 OpenAI 供应商并填自定义 Base URL —— 那个供应商会对 gpt-5 开头的模型名自动切换参数。DeepSeek、GLM、Kimi、Claude、gpt-4.x 不受影响。
Base URL 填到 /v1 为止，不要带 /chat/completions。客户端会自己拼接后面的路径；多写会得到 404。
模型名必须与定价页里的 ID 完全一致（例如 deepseek-v4-pro，不是 DeepSeek V4 Pro）。大小写、连字符都算。