飞书 / n8n / Coze 等低代码平台

只要平台能发 HTTP 请求，就能接入。两条铁律：关流式、放宽超时。

适用范围

这些平台没有「AI 模型」这种专门的积木，但都提供「发送 HTTP 请求」的动作，配上我们的地址和密钥即可。

我们是标准 OpenAI 格式，凡是能填 base_url + API Key 的地方，直接用 https://api.qiyuanapi.cc/v1 即可，不需要另做适配。

飞书多维表格 — 自动化流程里的「发送 HTTP 请求」
n8n — HTTP Request 节点
Coze / Dify — 自定义插件、HTTP 工具
Zapier / Make — Webhooks by Zapier、HTTP 模块
任何支持自定义 HTTP 的工单、CRM、低代码系统

两条铁律（不看这里必踩坑）

低代码平台和聊天客户端不一样，下面两点是这类接入 90% 问题的来源。

1. 1. stream 必须为 false

自动化流程一次性读取整个响应体，读不了流式的 SSE。传了 stream: true 会拿到一堆 data: 开头的碎片，或者直接超时。不传这个字段就是默认 false，最省事。

2. 2. 超时要按实际耗时放宽

很多平台的 HTTP 动作默认超时只有 10～30 秒。短问答没问题，长文总结和开着思考的请求会撞上。下一节有实测耗时，按它设；确定性任务把 reasoning_effort 设为 none 能明显缩短。

实测耗时（按这个设超时）

以下为非流式调用的端到端耗时，含排队与网络。建议超时至少设成表中数值的两倍。

自动化流程里的任务多数是确定性的（总结、分类、抽取、改写），建议直接传 reasoning_effort: none，又快又省。

对话 deepseek-v4.1，关闭思考（reasoning_effort: none）— 短问答约 1 秒，几千字总结约 3～8 秒
对话 deepseek-v4.1，默认开思考 — 再加 2～20 秒不等，取决于问题难度

对话调用

最通用的一种，任何平台照抄即可。

回复正文在 choices[0].message.content。大多数平台用 $.choices[0].message.content 这样的 JSONPath 取值。

POST https://api.qiyuanapi.cc/v1/chat/completions

Headers:
  Authorization: Bearer sk-opc-你的密钥
  Content-Type: application/json

Body:
{
  "model": "deepseek-v4.1",
  "messages": [
    { "role": "user", "content": "把下面这段话总结成一句话：{{表格字段}}" }
  ],
  "reasoning_effort": "none",
  "stream": false
}

飞书多维表格：具体步骤

密钥直接写在请求头里，等于把密钥交给了这张表的所有协作者。建议单独建一把密钥专供自动化使用，并在控制台给它设 IP 白名单，出问题时可以单独停掉而不影响你自己的调用。

1. 打开自动化

在多维表格右上角点「自动化」→「新建自动化流程」。

2. 选触发条件

常用的是「当记录被更新时」或「当新增记录时」。也可以用「手动触发」先跑通再改成自动。

3. 加一个「发送 HTTP 请求」动作

请求方法选 POST，URL 填下面的地址，请求头加两条，请求体里用 {{字段名}} 引用表格里的列。

URL:    https://api.qiyuanapi.cc/v1/chat/completions
Method: POST

Header:
  Authorization: Bearer sk-opc-你的密钥
  Content-Type: application/json

Body:
{
  "model": "deepseek-v4.1",
  "messages": [{"role": "user", "content": "{{需求描述}}"}],
  "reasoning_effort": "none",
  "stream": false
}

4. 把结果写回表格

再加一个「更新记录」动作，取上一步响应里的 choices[0].message.content，写进目标字段。

常见报错对照

401 unauthorized — 密钥写错，或 Bearer 后面漏了空格
402 — 余额不足，去控制台充值
403 model_not_allowed — 这把密钥没勾选该模型，去控制台的密钥设置里加上
404 model_unavailable — 模型名拼错，报错信息里会直接列出当前可用的模型名
超时 / 无响应 — 先确认 stream 是不是没关；再按上面的耗时表把超时调大
返回一堆 data: 开头的碎片 — stream 没关

平台超时太短怎么办

如果平台的 HTTP 动作最长只能等 30 秒，而任务要处理很长的输入，余量可能不够。按推荐顺序：

我们的接口本身没有 30 秒限制，超时来自平台侧的动作配置。不确定的话先用 cURL 在本地跑一遍，确认接口通了，再去排查平台配置。

先关思考 — 传 reasoning_effort: none，多数流程任务不需要推演
拆短输入 — 把长文按段落分多次调用，再合并结果
把长任务拆到平台外 — 用一个自己的小服务（或 n8n 这类支持长时任务的平台）接收请求、调用我们的接口、完成后回写表格

POST https://api.qiyuanapi.cc/v1/chat/completions Headers: Authorization: Bearer sk-opc-你的密钥 Content-Type: application/json Body: { "model": "deepseek-v4.1", "messages": [ { "role": "user", "content": "把下面这段话总结成一句话：{{表格字段}}" } ], "reasoning_effort": "none", "stream": false }

URL: https://api.qiyuanapi.cc/v1/chat/completions Method: POST Header: Authorization: Bearer sk-opc-你的密钥 Content-Type: application/json Body: { "model": "deepseek-v4.1", "messages": [{"role": "user", "content": "{{需求描述}}"}], "reasoning_effort": "none", "stream": false }