احراز هویت

با یک سرآیند به API OneProvider وارد شوید: توکن Bearer مثل OpenAI یا x-api-key مثل Anthropic. فقط یکی را بفرستید، نه هر دو. همراه با نمونهٔ متغیرهای محیطی.

OneProvider هم Bearer به سبک OpenAI و هم x-api-key به سبک Anthropic را می‌پذیرد. یکی از این دو را بفرستید، نه هر دو.

همهٔ مدل‌ها، قابلیت‌ها و قیمت‌ها فهرست مستندات برای عامل‌های هوش مصنوعی: https://oneprovider.dev/docs/llms.txt پیش از شروع: یک کلید از حساب کاربری حساب کاربری خود را باز کنید: ربات Telegram به نام @oneprovider_robot (بخش «حساب کاربری») یا app.oneprovider.dev . «صدور کلید» را بزنید، یک نام (مثلاً نام همین کلاینت) و سقف مصرف بدهید و کلید را کپی کنید. شارژ موجودی هم همان‌جاست. اطلاعات بیشتر دربارهٔ حساب کاربری و کلیدها .

شکل‌های هدر

API هر کدام از این دو هدر را می‌پذیرد. همان را به کار ببرید که SDK شما از قبل ارسال می‌کند.

http

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

متغیرهای محیطی

در مثال‌های ما کلید در ONEPROVIDER_KEY نگهداری می‌شود. اما کلاینت‌های SDK به‌طور پیش‌فرض نام‌های بومی خودشان را می‌خوانند — یا کلید را با همان نام export کنید، یا ONEPROVIDER_KEY را صریحاً به constructor بدهید. جدول زیر نشان می‌دهد هر ابزار چه چیزی را می‌خواند:

داده‌های مرجع

کلاینت	متغیر کلید	متغیر base URL
Anthropic Python / Node SDK	`ANTHROPIC_API_KEY`	`ANTHROPIC_BASE_URL`
OpenAI Python / Node SDK	`OPENAI_API_KEY`	`OPENAI_BASE_URL` یا `OPENAI_API_BASE`
Claude Code CLI	`ANTHROPIC_AUTH_TOKEN`	`ANTHROPIC_BASE_URL`
Cursor	Settings → Models → API key	Settings → Models → Base URL

بررسی احراز هویت

برای یک بررسی ارزان و بدون اثر جانبی، به /v1/models درخواست بزنید:

bash

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

پاسخ موفق فهرست مدل‌های فعلی را برمی‌گرداند. 401 در اینجا یعنی قالب کلید نادرست است، کلید لغو شده یا هنوز فعال نشده است.

کلید را کجا نگه دارید

متغیرهای محیطی — گزینهٔ پیش‌فرض برای بیشتر موارد.
~/.zshrc / ~/.bashrc همراه با HISTCONTROL=ignorespace، تا دستورهایی که با فاصله شروع می‌شوند وارد تاریخچهٔ shell نشوند.
مدیران راز: 1Password CLI، AWS Secrets Manager، Doppler، GCP Secret Manager.
فایل‌های .env مخصوص هر پروژه — همیشه در .gitignore.

کلید را به مرورگر نفرستید کلیدهای OneProvider اعتبارنامهٔ حامل (bearer) هستند. هرگز آن‌ها را در bundle مرورگر یا در نسخهٔ عمومی اپ موبایل قرار ندهید. به‌جای آن از طریق بک‌اند خودتان پروکسی کنید.

اشتباهات رایج

اسلش پایانی. https://api.oneprovider.dev/v1/ در برابر https://api.oneprovider.dev/v1 — بعضی SDKها مسیر را ساده‌لوحانه به هم می‌چسبانند. شکل بدون اسلش پایانی را که بالا آمده به کار ببرید.
Bearer دوبار. Authorization: Bearer Bearer sk-... وقتی پیش می‌آید که ابزار خودش Bearer را به ابتدای مقدار اضافه می‌کند و شما هم دوباره آن را نوشته‌اید. پیشوند را در تنظیمات خودتان حذف کنید.
هدر نسخهٔ Anthropic. در فراخوانی‌های HTTP خام همیشه anthropic-version: 2023-06-01 را اضافه کنید. SDKها آن را خودشان اضافه می‌کنند.

چرخش کلیدها

در حساب کاربری یک کلید جدید صادر کنید («کلیدها» ← «صدور کلید»)، آن را در کلاینت‌هایتان به‌روز کنید و بعد کلید قدیمی را حذف کنید. فوری و رایگان است و موجودی بین همهٔ کلیدهای حساب کاربری مشترک است. بیشتر: حساب کاربری و کلیدها .

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

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

آخرین به‌روزرسانی: 2026-11-08 باگی پیدا کردید؟ @Oneproviderhelpbot