OneProvider

مستندات API مدل‌های Claude و GPT: کلیدها، SDKها، کلاینت‌ها

شروع سریع API هوش مصنوعی OneProvider: کلید بگیرید، base URL را تنظیم کنید و کلاینت‌تان را وصل کنید. راهنمای Claude Code، Cursor، Codex و SDKها با نمونه.

یک کلید و دو base URL سازگار برای مدل‌های عملیاتی، کلاینت‌ها و APIهای رسانه.

همهٔ مدل‌ها، قابلیت‌ها و قیمت‌ها فهرست مستندات برای عامل‌های هوش مصنوعی: https://oneprovider.dev/docs/llms.txt

برای عامل هوش مصنوعی

گیر کرده‌اید؟ به یک عامل هوش مصنوعی بسپارید

پیوند زیر را برای هر عامل هوش مصنوعی (Claude Code، Codex، Cursor…) بفرستید و از او بخواهید کلاینت شما را راه‌اندازی کند: هرچه یک عامل لازم دارد، از تنظیمات هر کلاینت تا بررسی نهایی، در آن هست.

https://oneprovider.dev/docs/llms.txt

سه گام

  1. کلید را از حساب کاربری بگیرید

    حساب کاربری را باز کنید، موجودی را شارژ کنید (یا یک کد مارکت‌پلیس را فعال کنید) و «صدور کلید» را بزنید.

    app.oneprovider.dev چگونه کار می‌کند

  2. کلاینت خود را انتخاب کنید

    هر کلاینت راهنمای کوتاه خودش را دارد.

    • Claude Code
    • Claude Desktop
    • Codex (OpenAI)
    • Cursor
    • Hermes Agent
    • Cline
    • OpenClaw
    • VS Code
    • OpenCode
    • Open Cowork
    • Factory Droid
    • n8n
    • Python SDK
    • Node SDK

  3. base URL و کلید را تنظیم کنید

    کلید در هدر x-api-key یا Authorization: Bearer قرار می‌گیرد. آدرس به نوع کلاینت بستگی دارد:

    Anthropic (Claude Code، Anthropic SDK)، بدون /v1 https://api.oneprovider.dev OpenAI (Codex، Cursor، OpenAI SDK)، با /v1 https://api.oneprovider.dev/v1 bash 
    curl -s https://api.oneprovider.dev/v1/models \
-H "Authorization: Bearer sk-your-key-here"

    اگر در پاسخ فهرستی از مدل‌ها آمد، کلید کار می‌کند.

بعدی

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

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