不在节点中硬编码 Key，调用 OpenAI 兼容 API。

配置一个明确的 HTTP Request

以官方节点行为作为接入边界

n8n HTTP Request 官方文档支持任意 REST URL、通用凭据、Header、JSON Body、cURL 导入、响应设置、批处理、代理和超时；凭据文档把 Bearer Auth 列为通用凭据类型。

打开 n8n 前先获取当前模型 ID

test -n "$PRIMORDIAL_API_KEY" || {
  echo "PRIMORDIAL_API_KEY 未设置" >&2
  exit 1
}

curl --fail-with-body --silent --show-error \
  https://www.primoraihub.com/v1/models \
  -H "Authorization: Bearer $PRIMORDIAL_API_KEY" \
  | jq -r '.data[]?.id'

把其中一个准确返回 ID 复制到第一次冒烟测试。不要使用猜测名称、旧文章示例或字面量 MODEL_ID_FROM_V1_MODELS。

Bearer Auth 只保存 Token

1. 在 HTTP Request 节点选择 Generic Credential Type。
2. 选择 Bearer Auth，创建一个专用凭据。
3. 只粘贴 Primordial AI Token，不要添加 Bearer。
4. 按环境和用途命名；当前版本提供域名限制时，将允许域名限制为 www.primoraihub.com。

n8n Bearer Auth 会自动添加 Authorization: Bearer 前缀。Token 字段再次填写前缀，可能形成重复内容并返回 HTTP 401。

先运行静态、类型正确的 JSON 冒烟测试

启用 Send Body，选择 JSON 和 Using JSON，再替换模型占位符：

{
  "model": "MODEL_ID_FROM_V1_MODELS",
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK"
    }
  ],
  "stream": false
}

只执行一次节点。成功响应只能证明当时的 Token、模型、接口、非流式 Body 和 n8n execution 成功；该请求可能消耗账户额度。

也可以在 n8n 选择 Import cURL。导入不含真实 Authorization Header 的 cURL，再单独关联 Bearer 凭据。n8n 文档说明导入参数会成为字符串，因此应重新用 JSON 模式输入 Body，让 false 保持布尔类型。

静态测试通过后再映射工作流数据

如果上游节点输出 prompt 字段，把 JSON Body 改成返回对象的 n8n 表达式：

{{
  {
    "model": "MODEL_ID_FROM_V1_MODELS",
    "messages": [
      {
        "role": "user",
        "content": $json.prompt
      }
    ],
    "stream": false
  }
}}

请求前验证缺失、空值、过长和非字符串输入。后续节点需要把响应与输入对应时，应保留原始工作流 Item 或关联字段。

只重试临时失败，不重试配置错误

n8n HTTP Request 常见问题文档说明了 batching 和 Retry on Fail。应设置有限次数与等待间隔，不能用自动重试掩盖鉴权、路由或 Schema 缺陷。

不能让凭据进入节点和导出文件

• 按工作流和环境使用专用 Key。
• 不能把真实 Key 粘贴到 Header 字段、JSON Body、Sticky Note、execution 名称或导出的工作流。
• 限制可以编辑或运行工作流、使用凭据的成员。
• Prompt 或响应包含敏感业务数据时，限制或清理 execution data。
• 怀疑暴露后轮换 Key，只更新 n8n Credential。

n8n 的工作流共享文档说明，即使凭据没有单独共享，编辑者仍可运行使用该凭据的工作流。应把工作流访问视为消耗提供商账户的权限。

常见问题