n8n

用最普通的 HTTP Request 节点从 n8n 调用 OneProvider。无需自定义社区节点——原生的 Anthropic Messages API 开箱即用。

1. 创建凭据

在 n8n 中依次选择 Credentials（凭据）→ New（新建）→ Header Auth，并设置：

• Name: x-api-key
• Value（值）：您的 OneProvider 密钥（sk-...）

2. HTTP Request node

把 HTTP Request 节点拖入工作流，并按如下方式配置：

Method: POST
URL: https://api.oneprovider.dev/v1/messages
Authentication: Header Auth → (the credential above)
Headers:
anthropic-version: 2023-06-01
content-type: application/json
Body (JSON):
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "{{$json.prompt}}" }
]
}

表达式 {{$json.prompt}} 会取自上一个节点的文本；您也可以换成任何能得到字符串的 n8n 表达式。

流式输出

在请求体中加入 "stream": true，并把节点的 Response → Response Format 切换为 String。n8n 会收到 SSE 字节流；请在下游的 Function 节点中解析 data: 行。

如何选择模型

把模型 ID 写在 JSON 请求体里。claude-sonnet-5-5 是多数工作流的默认选择：价格与质量均衡，适合摘要、分类和起草。大批量的简单步骤（如打标签或分流）使用 claude-haiku-5-5，需要深度推理的步骤使用 claude-opus-5-5。务必设置 max_tokens：Messages API 要求必须提供。ID 见模型页面 ，费率见价格页面 ；为密钥设置消费限额，可以保护出现循环的工作流。

常见错误与解决办法

401 authentication_error

Header Auth 凭据的名称必须恰好是 x-api-key，值为完整的密钥。请检查节点确实使用了这个凭据。

HTTP Request 节点出现 404

URL 必须是 https://api.oneprovider.dev/v1/messages。缺少 /v1 或多写一个，都会返回 404。

400 invalid_request_error

请检查 JSON 请求体：必须有 model、max_tokens 和非空的 messages 数组，并且表达式 {{$json.prompt}} 得到的必须是字符串，而不是对象。

429 “Insufficient balance”，而且节点一直在重试

请关闭该节点的 Settings → Retry On Fail，或者限制重试次数：响应带有 x-should-retry: false，重试只会浪费时间。请改为给个人中心充值余额。

节点在较长的回答上超时

请调高节点的 Options → Timeout，或使用 "stream": true。非流式请求必须在 6 分钟内开始返回响应。

找不到回答文本

使用 Messages API 时，文本在 {{$json.content[0].text}} 中。使用 /v1/chat/completions 时，则在 {{$json.choices[0].message.content}} 中。

常见问题

需要社区节点吗？

不需要。标准的 HTTP Request 节点就够了。

能使用 n8n 内置的 OpenAI 节点吗？

通常可以：创建一个 OpenAI 凭据，把它的 Base URL 设为 https://api.oneprovider.dev/v1，然后手动从目录中填写模型 ID。

怎样避免某个工作流花费过多？

为 n8n 单独签发一个带消费限额的密钥，并只在那里使用。

也能调用 GPT 模型吗？

可以，使用同一个密钥，通过 https://api.oneprovider.dev/v1/chat/completions 发送 OpenAI 风格的请求体，见 Chat Completions 。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。