API هوش مصنوعی

اتصال به برنامه‌ها

سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.

۱ سیستم‌عامل

Windows
ویندوز ۱۰ و ۱۱
macOS
مک
Linux
اوبونتو، فدورا و…
Android
گوشی و تبلت اندروید

۲ برنامه

Claude Code
ایجنت کدنویسی Anthropic در ترمینال
Cursor
ویرایشگر کد هوشمند
VS Code
ویرایشگر + افزونه
Codex CLI
ایجنت کدنویسی OpenAI در ترمینال
Cherry Studio
اپ چت دسکتاپ (جایگزین اپ ChatGPT/Claude)

برای اپ رسمی Claude فقط مدل‌های Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.

کلید فقط در مرورگر شما جایگزین می‌شود و جایی ارسال نمی‌شود.

وارد شوید تا بتوانید همین‌جا کلید بسازید.

ضریب مصرف هر مدل در صفحه‌ی مدل‌ها آمده است.

راهنمای اتصال Codex CLI

Windows · ۶ قدم
  1. ۱

    انتخاب یا ساخت کلید API

    از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمه‌ی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر می‌شوند.

    کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود. آن را در جای امنی نگه دارید و در گروه‌ها یا اسکرین‌شات‌ها منتشر نکنید.

  2. ۲

    نصب Node.js و Codex

    Node.js نسخه‌ی ۱۸ یا بالاتر را از nodejs.org نصب کنید، سپس در ترمینال:

    ترمینال
    npm install -g @openai/codex
  3. ۳

    ساخت فایل تنظیمات Codex

    تنظیمات در فایل %USERPROFILE%\.codex\config.toml قرار می‌گیرد. این دستور فایل را باز می‌کند:

    ترمینال
    New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
    notepad "$env:USERPROFILE\.codex\config.toml"
  4. ۴

    وارد کردن آدرس و مدل

    متن زیر را در فایل بگذارید و ذخیره کنید:

    config.toml
    model = "claude-sonnet-5"
    model_provider = "api2928"
    
    [model_providers.api2928]
    name = "2928"
    base_url = "https://api.2928.ir/v1"
    env_key = "API2928_KEY"
    wire_api = "responses"
  5. ۵

    ذخیره‌ی کلید در متغیر محیطی

    Codex کلید را از متغیر API2928_KEY می‌خواند. این دستور آن را برای همیشه ذخیره می‌کند:

    PowerShell
    setx API2928_KEY "sk-..."

    بعد از setx ترمینال (و VS Code) را ببندید و دوباره باز کنید تا متغیر خوانده شود.

  6. ۶

    اجرا

    در پوشه‌ی پروژه دستور codex را بزنید و یک پیام کوتاه بفرستید.

    ترمینال
    codex

    اگر Codex از شما خواست با حساب ChatGPT وارد شوید، یعنی فایل تنظیمات یا متغیر کلید خوانده نشده؛ مسیر فایل و نام متغیر را بررسی کنید و ترمینال را از نو باز کنید.

خطاهای رایج

401 (Unauthorized)
کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
403 (اعتبار تمام شده)
اعتبار حساب تمام یا منقضی شده است. از صفحه‌ی «خرید اعتبار» بسته بخرید یا تمدید کنید.
503 — model_not_found
نام مدل اشتباه است. نام را دقیقاً از صفحه‌ی «مدل‌ها» کپی کنید.
404 (Not Found)
آدرس پایه باید https://api.2928.ir/v1 باشد. خود برنامه مسیر /chat/completions را اضافه می‌کند؛ آن را به آدرس اضافه نکنید.
پاسخ دیر شروع می‌شود
مدل‌های بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا ده‌ها ثانیه قبل از شروع پاسخ فکر می‌کنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

بگویید در کدام قدم ماندید و متن خطا را بفرستید.

تماس با پشتیبانی