n8n

OneProvider را در n8n با یک نود ساده HTTP Request فراخوانی کنید. نود سفارشی جامعه لازم نیست — 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 را دریافت می‌کند؛ خط‌های data: را در یک نود Function پایین‌دست تجزیه کنید.

کدام مدل را انتخاب کنیم

شناسهٔ مدل را در بدنهٔ JSON بگذارید. claude-sonnet-5-5 پیش‌فرض بیشتر گردش‌کارهاست: قیمت و کیفیت متعادل برای خلاصه‌سازی، دسته‌بندی و پیش‌نویس. claude-haiku-5-5 را برای گام‌های ساده و پرحجم مثل برچسب‌گذاری یا مسیریابی و claude-opus-5-5 را برای گام‌هایی که استدلال عمیق می‌خواهند به کار ببرید. همیشه max_tokens را تنظیم کنید: Messages API آن را لازم دارد. شناسه‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است؛ سقف مصرف روی کلید از گردش‌کاری که در حلقه می‌افتد محافظت می‌کند.

خطاهای رایج و راه‌حل‌ها

401 authentication_error

اعتبارنامهٔ Header Auth باید دقیقاً نام x-api-key و کل کلید را به‌عنوان مقدار داشته باشد. بررسی کنید که نود واقعاً از همین اعتبارنامه استفاده می‌کند.

404 در نود HTTP Request

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 کافی است.

می‌توانم از نودهای داخلی OpenAI در n8n استفاده کنم؟

معمولاً بله: یک اعتبارنامهٔ OpenAI بسازید و Base URL آن را روی https://api.oneprovider.dev/v1 بگذارید، سپس شناسهٔ مدل را از کاتالوگ دستی انتخاب کنید.

چطور جلوی خرج زیاد یک گردش‌کار را بگیرم؟

برای n8n کلید جداگانه با سقف مصرف صادر کنید و فقط همان‌جا به کار ببرید.

می‌توانم مدل‌های GPT را هم فراخوانی کنم؟

بله، از طریق https://api.oneprovider.dev/v1/chat/completions با همان کلید و بدنه به سبک OpenAI، به Chat Completions نگاه کنید.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات 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 و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .