月度归档: 2026 年 5 月

N8n deepai gpt5 unsupported stop parameter.png

n8n 接入 DeepAI API 中转站:GPT-5 unsupported STOP parameter 怎么修n8n 接入 DeepAI API 中转站:GPT-5 unsupported STOP parameter 怎么修

n8n 的 OpenAI Chat Model 节点接入 GPT-5 或 OpenAI-compatible Provider 时,如果报 unsupported STOP parameter,即使界面里没有手动设置 stop,也要检查旧 LangChain 依赖、旧 AI Agent 模板和请求体透传。本文结合 n8n Issue #18149 和 PR #18213,整理 DeepAI API 中转站场景下的排查与修复方法。

Cherry studio deepai gpt5 reasoning effort 400.png

Cherry Studio 接入 DeepAI API 中转站:GPT-5 reasoning.effort 400 怎么排查Cherry Studio 接入 DeepAI API 中转站:GPT-5 reasoning.effort 400 怎么排查

Cherry Studio 通过 OpenAI-compatible Provider 接入 GPT-5 系列模型时,reasoning effort 需要按模型能力传参:gpt-5/gpt-5-mini/gpt-5-nano 支持 minimal/low/medium/high,但 gpt-5-chat-latest 可能不支持 reasoning.effort。本文结合 Cherry Studio Issue #9013 和 PR #8945,整理 DeepAI API 中转站场景下的排查与配置方法。

Dify deepai max completion tokens reasoning model.png

Dify 接入 DeepAI API 中转站:max_tokens 不支持改用 max_completion_tokensDify 接入 DeepAI API 中转站:max_tokens 不支持改用 max_completion_tokens

Dify 使用 OpenAI-API-compatible Provider 接入 o1、GPT-5 或其他 reasoning 模型时,如果模型校验或运行报 Unsupported parameter: max_tokens,通常要改用 max_completion_tokens。本文结合 Dify Issue #10348、官方插件 Issue #1845 和 PR #2713/#2771,整理 DeepAI 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 中转站多模型路由场景下的排查和修复思路。