必须绕过OpenAI兼容层直连SambaNova专有API，配置正确Endpoint、API Key及X-SambaNova-Request-ID头，否则请求被拒绝或降级；需在Dify中添加Custom供应商、绑定同名模型、启用流式与函数调用，并通过耗时、抓包、响应头三重验证直连生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中启用SambaNova硬件加速的超高速推理能力，必须绕过默认的OpenAI兼容层，直接对接其专有REST API端点并配置专属认证头，否则请求将被网关拒绝或降级为通用LLM路由。
确认SambaNova服务已就绪并获取访问凭证
登录SambaNova Cloud控制台（https://cloud.sambanova.ai），进入「API Keys」页面，点击「Create API Key」生成新密钥。注意该密钥仅显示一次，【务必立即复制保存】，丢失后需重新创建且旧密钥自动失效。
在「Deployments」列表中找到已部署的模型实例（如sn-16b-prod-v2），记录其Endpoint URL，格式类似 https://api.sambanova.ai/v1/deployments/sn-16b-prod-v2/chat/completions。
打开终端，用curl测试连通性：curl -X POST "$ENDPOINT" -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" -d '{"messages":[{"role":"user","content":"Hello"}]}'。若返回200及JSON响应体，说明网络与凭证均有效。
在Dify中添加SambaNova为自定义模型供应商
进入Dify管理后台 → 「设置」→「模型供应商」→「添加模型供应商」→ 选择「Custom」类型。
填写以下字段：
- 供应商名称：填 SambaNova-Prod（不可含空格或特殊字符，后续模型绑定依赖此标识）
- API Base URL：粘贴上一步获取的完整Endpoint URL，【必须精确到/completions结尾，不能只填到/v1/deployments/】
- API Key：粘贴刚复制的密钥字符串
- 请求头配置：在「Custom Headers」区域新增一行，Key填
X-SambaNova-Request-ID，Value留空（Dify会自动注入UUID）
点击「保存」。此时供应商状态应显示“已连接”，若为红色感叹号，请检查URL末尾是否遗漏/completions路径或密钥是否误带换行符。
创建并绑定SambaNova专属模型
第一步：在「模型供应商」列表中找到刚添加的 SambaNova-Prod 条目，点击右侧「+ 添加模型」按钮。
第二步：填写模型信息：
大模型 Token 成本节约工具。在请求到达大模型之前自动压缩 prompt 和上下文，减少 60-95% 的 token 消耗，直接降低 API 成本。支持 Claude/OpenAI/Gemini 等主流模型，提供代理模式、CLI 包装、Python SDK 和 MCP Server 四种接入方式。内置一键安...
- 模型名称：sn-16b-prod-v2（必须与SambaNova控制台中Deployment名称完全一致，大小写敏感）
- 上下文长度：32768（SambaNova该型号实际支持值，填错会导致长文本截断）
- 最大输出长度：4096
- 支持的功能：勾选「流式响应」「函数调用」（SambaNova v2 API原生支持，不勾选将禁用对应工作流节点）
第三步：点击「保存」，模型即出现在「模型列表」中，状态为「已启用」。
第四步：进入任意应用 → 「设置」→「模型配置」→ 在「推理模型」下拉菜单中选择 sn-16b-prod-v2 → 点击「保存并发布」。
验证超高速推理是否生效
方法一：使用Dify内置调试器
打开一个已绑定SambaNova模型的应用 → 点击右上角「调试」→ 在输入框发送“请用一句话解释量子纠缠”，观察右下角「执行耗时」数字——正常应显示 1.2s～2.8s（非GPU服务器本地模型通常需8s以上）。
方法二：抓包确认请求未经过OpenAI代理层
在Dify服务器执行 sudo tcpdump -i any -A port 8000 | grep -i "sambanova"（假设Dify API服务监听8000端口），发起一次聊天请求，若捕获到包含 /v1/deployments/sn-16b-prod-v2/ 的HTTP POST请求，则证明流量直连SambaNova，未走任何中间转换层。
方法三：检查响应头中的x-sambanova-model-id字段
用curl调用Dify的/app/{app_id}/chat-messages接口，查看返回Header，存在 x-sambanova-model-id: sn-16b-prod-v2 即表示底层调用成功透传。
