分类: OpenAI Compatible API

OpenAI Compatible API、Base URL、API Key、模型 ID 和客户端接入教程。

Dify deepai tool calling array schema missing items.png

Dify 接入 DeepAI API 中转站:Tool Calling 报 array schema missing items 怎么排查Dify 接入 DeepAI API 中转站:Tool Calling 报 array schema missing items 怎么排查

Dify 自定义工具接入 OpenAI 插件或 API 中转站时,如果 Tool Calling 报 invalid_function_parameters:array schema missing items,根因通常不是 Key 或 Base URL,而是工具 JSON Schema 的 array 参数缺少 items。本文结合 Dify GitHub Issue #32894 和 PR #33137,整理排查步骤、修复示例与

Openclaw deepai gemini tool call thought signature.png

OpenClaw 接入 DeepAI API 中转站:Gemini 工具调用 400 与 thought_signature 透传OpenClaw 接入 DeepAI API 中转站:Gemini 工具调用 400 与 thought_signature 透传

OpenClaw 通过 OpenAI-compatible 网关调用 Gemini 工具时,第一次 tool call 成功但回传 tool result 后 400,提示缺少 thought_signature 怎么办?本文结合 OpenClaw GitHub 已关闭 Issue,整理 DeepAI API 中转站、provider-specific metadata、tool_calls 和工具结果回传排查方法。

N8n deepai tools agent bindtools tool calling.png

n8n 接入 DeepAI API 中转站:Tools Agent 提示模型不支持工具调用怎么排查n8n 接入 DeepAI API 中转站:Tools Agent 提示模型不支持工具调用怎么排查

n8n Tools Agent 使用 OpenAI-compatible Provider 时,模型明明支持 tool calling 却提示不支持 bindTools 怎么办?本文结合 n8n GitHub 已关闭 Issue,整理 DeepAI API 中转站、Chat Model、Base URL、多轮工具历史和 provider 兼容性排查方法。

Dify deepai custom embedding knowledge base empty.png

Dify 接入 DeepAI API 中转站:自定义 Embedding 后知识库为空怎么排查Dify 接入 DeepAI API 中转站:自定义 Embedding 后知识库为空怎么排查

Dify 自托管使用 OpenAI-compatible Embedding Provider 时,API 手动测试成功但知识库处理后为空怎么办?本文结合 Dify GitHub 已关闭 Issue,整理 DeepAI API 中转站、Docker 网络、默认 LLM、分段长度和 documents 表错误排查方法。

Cherry studio deepai pdf file data base64.png

Cherry Studio 接入 DeepAI API 中转站:PDF file_data 的 Data URL 前缀与 Base64 解码排查Cherry Studio 接入 DeepAI API 中转站:PDF file_data 的 Data URL 前缀与 Base64 解码排查

Cherry Studio 通过 OpenAI-compatible API 上传 PDF 后文件损坏怎么办?本文结合 Cherry Studio GitHub 已关闭 Issue,说明 Data URL 前缀、纯 Base64、file_data 解码、SHA256 校验和 DeepAI API 中转站文件处理最佳实践。

Openclaw deepai stream options include usage.png

OpenClaw 接入 DeepAI API 中转站:流式请求 Token 用量为 0 与 include_usage 排查OpenClaw 接入 DeepAI API 中转站:流式请求 Token 用量为 0 与 include_usage 排查

OpenClaw 使用自定义 OpenAI-compatible Provider 流式调用时,转录和仪表盘 Token 用量为 0 怎么办?本文结合 OpenClaw GitHub 已关闭 Issue,整理 stream_options.include_usage、DeepAI API 中转站日志和成本控制排查方法。

Openclaw deepai openai compatible messages context loss.png

OpenClaw 接入 DeepAI API 中转站:OpenAI-Compatible 请求丢失历史 messages 怎么排查OpenClaw 接入 DeepAI API 中转站:OpenAI-Compatible 请求丢失历史 messages 怎么排查

OpenClaw 使用 OpenAI-compatible Provider 时,调试轨迹显示完整上下文,但发给模型网关的请求只包含当前消息,导致模型忘记上文和工具续接失败。本文结合 OpenClaw GitHub 已关闭 Issue,整理 DeepAI API 中转站的请求体、messages、tool_calls 和日志排查方法。

Hermes agent deepai custom provider auxiliary.png

Hermes Agent 接入 DeepAI API 中转站:custom Provider 辅助任务走错端点怎么排查Hermes Agent 接入 DeepAI API 中转站:custom Provider 辅助任务走错端点怎么排查

Hermes Agent 使用 custom OpenAI-compatible Provider 时,主模型能用但 approval、compression、title generation 等辅助任务 fallback 到错误端点怎么办?本文结合 Hermes Agent GitHub 已关闭 Issue,整理 DeepAI API 中转站接入、config.yaml 显式配置和日志排查方法。

Claude code deepai web search tool calling.png

Claude Code 接入 DeepAI API 中转站:正常对话可用但 Web Search 和工具调用失败怎么办Claude Code 接入 DeepAI API 中转站:正常对话可用但 Web Search 和工具调用失败怎么办

Claude Code 通过 API 中转站或兼容网关时,普通对话能用但 Web Search、MCP 或工具调用失败怎么办?本文结合 Bifrost GitHub 已关闭 Issue,整理 Base URL、Headers、模型能力和工具支持的排查方法。

N8n deepai openai node v2 404.png

n8n 接入 DeepAI API 中转站:凭据测试通过但 OpenAI Node v2 运行 404 怎么排查n8n 接入 DeepAI API 中转站:凭据测试通过但 OpenAI Node v2 运行 404 怎么排查

n8n OpenAI Node v2 使用自定义 Base URL 时,凭据测试成功但运行时报 404 怎么办?本文结合 n8n GitHub 已关闭 Issue,整理 DeepAI API 中转站接入、AI Agent 替代路径、模型 ID 和 Docker 日志排查方法。

Dify deepai openai compatible 404 401 tool calling.png

Dify 接入 DeepAI API 中转站:OpenAI-Compatible 404、401 与工具调用 400 排查Dify 接入 DeepAI API 中转站:OpenAI-Compatible 404、401 与工具调用 400 排查

Dify 添加 OpenAI-compatible 模型时遇到 404、401 或 vLLM tool choice 400 怎么办?本文结合 Dify GitHub 已关闭 Issue,整理 Base URL、API Key、模型验证和工具调用的排查顺序。

Cherry studio deepai v1 messages 404 fixed.png

Cherry Studio 接入 DeepAI API 中转站:/v1/messages 404 与 Base URL 避坑指南Cherry Studio 接入 DeepAI API 中转站:/v1/messages 404 与 Base URL 避坑指南

Cherry Studio 使用 OpenAI-compatible 或 Anthropic Messages 接口时,/v1/messages 被拼成 /v1/v1/messages 会导致 404。本文结合 GitHub 已关闭 Issue,整理 DeepAI API 中转站的 Base URL 配置、排查顺序和客户端接入建议。