分类: API 中转站

API 中转站、DeepAI、模型聚合、New API、One API 和开发者选型教程。

Openclaw deepai developer role 400 system role.png

OpenClaw 接入 DeepAI API 中转站:developer role 400 错误怎么修OpenClaw 接入 DeepAI API 中转站:developer role 400 错误怎么修

OpenClaw 通过 OpenAI-compatible Provider 接入 Qwen、DeepSeek、GLM、Kimi 或代理网关时,如果后端返回 developer is not one of system/user/assistant/tool/function,通常是 developer role 没有映射为 system。本文结合 OpenClaw Issue #27037 和 PR #29479,整理 DeepAI API 中转站场景下的排查与修复方法。

Openclaw deepai openai completions tools parameter.png

OpenClaw 接入 DeepAI API 中转站:openai-completions 不发送 tools 导致工具调用失效OpenClaw 接入 DeepAI API 中转站:openai-completions 不发送 tools 导致工具调用失效

OpenClaw 使用自定义 OpenAI-compatible Provider 时,如果请求里没有 tools 参数,模型可能只输出 JSON 文本而不会返回 tool_calls。本文结合 OpenClaw Issue #1866 / #8923,整理 DeepAI API 中转站场景下的复现、排查、升级和验证方法。

Openclaw deepai stream true sse wrapper no display.png

OpenClaw 接入 DeepAI API 中转站:stream=true 返回单个 JSON 导致界面不显示怎么修OpenClaw 接入 DeepAI API 中转站:stream=true 返回单个 JSON 导致界面不显示怎么修

OpenClaw openai-completions Provider 默认发送 stream:true,如果自定义 OpenAI-compatible model-router 只返回单个 chat.completion JSON,界面可能沉默不显示。本文结合 OpenClaw Issue #14262,说明为什么 stream:true 必须返回 text/event-stream SSE chunk,以及 DeepAI API 中转站/自建代理如何同时兼容流式和非流式响应。

N8n deepai json mode internal error response format.png

n8n 接入 DeepAI API 中转站:JSON mode 报 Internal Error 怎么定位真实 400n8n 接入 DeepAI API 中转站:JSON mode 报 Internal Error 怎么定位真实 400

n8n OpenAI 节点使用 JSON mode / response_format=json_object 时,如果只显示 Internal Error,真实上游错误可能是 messages 或 instructions 没有包含 json 关键字。本文结合 n8n Issue #10206 和 1.56.0 修复,整理 DeepAI API 中转站场景下如何定位真实 400、补充 JSON 输出说明和 Schema 约束。

Hermes agent deepai gpt5 custom endpoint api mode codex responses.png

Hermes Agent 接入 DeepAI API 中转站:gpt-5 自定义端点被强制走 codex_responses 怎么排查Hermes Agent 接入 DeepAI API 中转站:gpt-5 自定义端点被强制走 codex_responses 怎么排查

Hermes Agent 使用自定义 OpenAI-compatible 端点接入 API 中转站时,如果模型名以 gpt-5 开头,即使显式设置 api_mode=chat_completions,也可能被运行时强制切到 codex_responses,导致响应变慢或卡住。本文结合 Hermes Agent Issue #10473,整理 DeepAI API 中转站场景下的协议选择、模型命名和排查方法。

Openclaw deepai parallel tool calls 400 single tool call.png

OpenClaw 接入 DeepAI API 中转站:parallel_tool_calls 导致工具调用 400 怎么排查OpenClaw 接入 DeepAI API 中转站:parallel_tool_calls 导致工具调用 400 怎么排查

OpenClaw v2026.3.2 曾向所有 OpenAI-compatible Provider 强制发送 parallel_tool_calls:true,导致只支持单工具调用的模型返回 400 并让工具全部失效。本文结合 OpenClaw Issue #37048 和 PR #39356,整理 DeepAI API 中转站场景下如何识别、禁用和验证 parallel_tool_calls。

N8n deepai embeddings openai zero vector encoding format.png

n8n 接入 DeepAI API 中转站:Embeddings OpenAI 返回全 0 向量怎么修n8n 接入 DeepAI API 中转站:Embeddings OpenAI 返回全 0 向量怎么修

n8n Embeddings OpenAI 节点通过 OpenAI-compatible Embedding API 接入向量工作流时,如果返回全 0 向量,RAG 和 PGVector 检索会全部失效。本文结合 n8n Issue #16985 和 PR #20877,说明如何用 encodingFormat 参数修复 LM Studio 等兼容接口问题,并整理 DeepAI API 中转站场景下的排查方法。

Openclaw deepai memory lancedb custom embedding provider.png

OpenClaw 接入 DeepAI API 中转站:memory-lancedb 自定义 Embedding Provider 怎么配置OpenClaw 接入 DeepAI API 中转站:memory-lancedb 自定义 Embedding Provider 怎么配置

OpenClaw memory-lancedb 插件过去只支持官方 OpenAI embedding 模型,不能配置 baseUrl、自定义模型名和 dimensions。本文结合 OpenClaw Issue #8118 与已合并修复 #17874,整理通过 DeepAI API 中转站接入 OpenAI-compatible Embedding Provider 的配置、排查和上线验证方法。

Hermes agent deepai custom endpoint model lock.png

Hermes Agent 接入 DeepAI API 中转站:自定义端点多模型被锁定怎么排查Hermes Agent 接入 DeepAI API 中转站:自定义端点多模型被锁定怎么排查

Hermes Agent 使用自定义 OpenAI-compatible 端点接入多模型 API 中转站时,如果 hermes model 总是锁定第一次选择的模型,根因可能是 custom_providers[].model 已保存导致提前返回,不再探测 /v1/models。本文结合 Hermes Agent Issue #6862,整理 DeepAI API 中转站多模型路由场景下的排查和修复思路。

Cline deepai tool use xml context error.png

Cline 接入 DeepAI API 中转站:You did not use a tool 工具调用错误怎么排查Cline 接入 DeepAI API 中转站:You did not use a tool 工具调用错误怎么排查

Cline / Roo Code 类代码 Agent 通过 OpenAI-compatible Provider 接入中转站时,如果提示 You did not use a tool in your previous response,常见根因不是 Base URL,而是模型没有按 XML 工具格式输出、项目上下文过大或本地模型 context 太小。本文结合 Cline Issue #735,整理 DeepAI

Continue dev deepai openai compatible legacy completions.png

Continue.dev 接入 DeepAI API 中转站:Edit 和 Autocomplete 误走 /completions 怎么修Continue.dev 接入 DeepAI API 中转站:Edit 和 Autocomplete 误走 /completions 怎么修

Continue.dev 通过 OpenAI Provider 接入 API 中转站时,Chat 能正常请求 /chat/completions,但 Edit 和 Autocomplete 却请求旧 /completions 导致 405/404。本文结合 Continue Issue #3620,说明如何用 useLegacyCompletionsEndpoint:false 强制走 /chat/completions,并整理 DeepAI API 中转站场景下的排查方法。

N8n deepai tools agent cannot use tools with stream.png

n8n 接入 DeepAI API 中转站:Tools Agent 报 Cannot use tools with stream 怎么排查n8n 接入 DeepAI API 中转站:Tools Agent 报 Cannot use tools with stream 怎么排查

n8n AI Agent / Tools Agent 通过 OpenAI-compatible Chat Model 接入 API 中转站时,如果后端返回 Cannot use tools with stream,根因通常是工具调用链路带了 stream:true。本文结合 n8n Issue #13112 和 PR #16888,整理 DeepAI API 中转站场景下的定位、修复和验证方法。