آموزش استفاده از API رایگان برای استفاده از مدل‌های هوش مصنوعی در برنامه نویسی

امروزه برای استفاده از مدل‌های هوش مصنوعی مختلف، لزوماً لازم نیست برای هر سرویس به‌صورت جداگانه API تهیه کنیم. سرویس‌هایی مانند AgentRouter امکان دسترسی به مدل‌های مختلف هوش مصنوعی را از طریق یک API فراهم می‌کنند و می‌توان از این API در ابزارهایی مانند Trae، Cursor، Cline، Claude Code و سایر ابزارهای AI Coding استفاده کرد.

در این آموزش یاد می‌گیریم چگونه در AgentRouter حساب ایجاد کنیم، API Key دریافت کنیم و سپس آن را به یک ابزار هوش مصنوعی متصل کنیم.

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

AgentRouter چیست؟

AgentRouter یک سرویس واسط برای اتصال ابزارهای مختلف به مدل‌های هوش مصنوعی است.

مزیت اصلی آن این است که به‌جای اینکه برای هر ابزار یا هر مدل، تنظیمات کاملاً متفاوتی داشته باشیم، می‌توانیم API مربوط به AgentRouter را در ابزار موردنظر خود تنظیم کنیم.

طبق مستندات فعلی، AgentRouter از چندین ابزار AI Coding مانند Claude Code، Codex، Cline، Roo Code، Trae، Cursor و OpenCode پشتیبانی می‌کند.

API رایگان AgentRouter چگونه کار می‌کند؟

برای درک ساده‌تر، معماری را به شکل زیر در نظر بگیرید:

ابزار شما
   ↓
API Key
   ↓
AgentRouter
   ↓
مدل هوش مصنوعی
   ↓
پاسخ مدل

برای مثال اگر بخواهیم در یک IDE از یک مدل هوش مصنوعی استفاده کنیم، IDE درخواست خود را به API مربوط به AgentRouter ارسال می‌کند.

AgentRouter درخواست را دریافت کرده و آن را به مدل انتخاب‌شده منتقل می‌کند و پاسخ مدل را به IDE برمی‌گرداند.

بنابراین لازم نیست کد اصلی IDE را تغییر دهیم؛ معمولاً تنها کافی است API Key، Base URL و Model را تنظیم کنیم. مستندات AgentRouter نیز همین روش را برای ابزارهای مختلف توضیح داده‌اند.

مرحله اول: ایجاد حساب در AgentRouter

ابتدا وارد وب‌سایت AgentRouter شوید.

                          ====>         وب‌سایت AgentRouter

پس از ایجاد حساب و ورود به پنل، باید بتوانید بخش مربوط به API Key یا Token را پیدا کنید.

API Key در واقع کلید دسترسی شما به API است.

API Key چیست؟

API Key مانند یک رمز عبور برای API عمل می‌کند.

به همین دلیل نباید آن را در اختیار دیگران قرار دهید یا آن را داخل GitHub و سایر مخازن عمومی قرار دهید.

به‌عنوان مثال، این کار اشتباه است:

API_KEY = "sk-xxxxxxxxxxxxxxxx"

و بهتر است کلید را از طریق Environment Variable یا تنظیمات امن برنامه نگهداری کنید.

مرحله دوم: دریافت API Key

پس از ورود به حساب، از بخش مربوط به Token یا API Key یک کلید API ایجاد کنید.

در نهایت چیزی شبیه مقدار زیر خواهید داشت:

YOUR_API_KEY

مقدار واقعی API Key را باید از پنل خودتان دریافت کنید.

نکته امنیتی: API Key خود را در اختیار هیچ فرد دیگری قرار ندهید.

مرحله سوم: آشنایی با Base URL

یکی از مهم‌ترین تنظیمات هنگام استفاده از API، Base URL است.

اگر بخواهیم از API سازگار با OpenAI استفاده کنیم، طبق مستندات فعلی AgentRouter باید از این آدرس استفاده کنیم:

https://co.agentrouter.org/v1

در API سازگار با Anthropic، آدرس Base URL متفاوت است و /v1 نباید به انتهای آن اضافه شود.

بنابراین این دو را با یکدیگر اشتباه نگیرید:

OpenAI Compatible
https://co.agentrouter.org/v1

و:

Anthropic Compatible
https://co.agentrouter.org

این تفاوت بسیار مهم است؛ چون استفاده از URL اشتباه می‌تواند باعث خطای اتصال یا خطای 404 شود.

مرحله چهارم: انتخاب Model

بعد از API Key و Base URL، باید مدل موردنظر را مشخص کنیم.

Model ID به ابزاری که استفاده می‌کنیم و مدل‌هایی که برای API Key ما در دسترس هستند بستگی دارد.

برای مثال در مستندات فعلی نمونه‌هایی مانند:

gpt-5.5
kimi-k2.6
glm-5.1

برای OpenAI Compatible ذکر شده‌اند.

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

لیست مدل‌های قابل استفاده ممکن است تغییر کند و AgentRouter نیز اعلام کرده که مدل‌های قابل دسترس به Resource Pool مربوط به API Key بستگی دارد.

مرحله پنجم: اتصال API به Trae

یکی از کاربردهای جذاب AgentRouter، اتصال آن به IDEهای هوش مصنوعی مانند Trae است.

در Trae وارد تنظیمات شوید:

Settings
→ Models
→ Add Model
→ Custom Config

سپس اگر قصد استفاده از OpenAI Compatible را دارید، تنظیمات را مشابه زیر وارد کنید:

API Format:
OpenAI Completions
Request URL:
https://co.agentrouter.org/v1
Model ID:
YOUR_MODEL_ID
API Key:
YOUR_API_KEY

مقادیر YOUR_MODEL_ID و YOUR_API_KEY را با اطلاعات واقعی حساب خود جایگزین کنید.

طبق مستندات فعلی AgentRouter، Trae هم از Anthropic Messages و هم از OpenAI Completions پشتیبانی می‌کند.

بعد از ذخیره تنظیمات، یک پیام ساده مانند زیر ارسال کنید:

فقط پاسخ بده: OK

اگر مدل پاسخ داد، اتصال با موفقیت انجام شده است.

اتصال AgentRouter به Cursor

Cursor نیز امکان استفاده از APIهای سازگار با OpenAI را دارد.

در تنظیمات Cursor وارد بخش Models شوید و API Key مربوط به AgentRouter را وارد کنید.

سپس گزینه Override OpenAI Base URL را فعال کرده و آدرس زیر را قرار دهید:

https://co.agentrouter.org/v1

در نهایت API Key مربوط به AgentRouter را وارد کنید.

مستندات فعلی AgentRouter همین روش را برای Cursor توضیح می‌دهند؛ البته به دلیل محدودیت‌های خود Cursor، نحوه انتخاب مدل برای کاربران رایگان Cursor ممکن است محدود باشد.

استفاده در Cline

Cline نیز یکی از ابزارهایی است که می‌توان AgentRouter را به آن متصل کرد.

در تنظیمات Cline می‌توانید Provider را روی:

OpenAI Compatible

قرار دهید.

سپس:

Base URL:
https://co.agentrouter.org/v1
API Key:
YOUR_API_KEY
Model ID:
YOUR_MODEL_ID

را وارد کنید.

AgentRouter در مستندات خود هر دو روش Anthropic و OpenAI Compatible را برای Cline ارائه کرده است.

آیا برای استفاده از AgentRouter باید کدنویسی کنیم؟

خیر.

اگر هدف شما فقط استفاده از AgentRouter در ابزارهایی مانند Trae، Cursor یا Cline باشد، معمولاً نیازی به تغییر Source Code ابزار ندارید.

کافی است اطلاعات مربوط به:

API Key
Base URL
Model ID

را در محل مناسب وارد کنید.

AgentRouter نیز در مستندات خود تأکید کرده است که برای اتصال Agentها نیازی به تغییر Source Code آن‌ها نیست.

استفاده مستقیم از API در برنامه

یکی دیگر از کاربردهای AgentRouter این است که بتوانیم از API آن مستقیماً در برنامه خودمان استفاده کنیم.

برای مثال اگر یک API سازگار با OpenAI داشته باشیم، ساختار کلی درخواست می‌تواند به شکل زیر باشد:

POST https://co.agentrouter.org/v1/chat/completions

و در Header:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

و Body نیز متناسب با API و مدل انتخاب‌شده ارسال می‌شود.

به این ترتیب می‌توان AgentRouter را از داخل برنامه‌هایی که قابلیت ارسال HTTP Request دارند نیز استفاده کرد.

در کلاس آنلاین برنامه‌نویسی با هوش مصنوعی مهندس بهمن آبادی یاد می‌گیرید چگونه از ابزارها و مدل‌های هوش مصنوعی به‌صورت حرفه‌ای در فرایند برنامه‌نویسی استفاده کنید؛ از تحلیل و طراحی پروژه و تولید کد گرفته تا رفع خطا، Refactoring و توسعه سریع‌تر نرم‌افزار. هدف این دوره این است که هوش مصنوعی را به یک دستیار واقعی در مسیر برنامه‌نویسی شما تبدیل کنیم، نه صرفاً ابزاری برای تولید کد.

تفاوت API Key و Model چیست؟

این دو مفهوم را نباید با یکدیگر اشتباه گرفت.

API Key

مشخص می‌کند:

چه کسی اجازه استفاده از API را دارد؟

Model ID

مشخص می‌کند:

درخواست باید به کدام مدل ارسال شود؟

مثلاً:

API Key:
xxxxxxxxxxxxxxxx

Model:
gpt-5.5

پس API Key هویت و دسترسی را مشخص می‌کند و Model ID مدل مورد استفاده را مشخص می‌کند.

خطاهای رایج

خطای 401

اگر خطای:

401 Unauthorized

دریافت کردید، ابتدا API Key را بررسی کنید.

موارد زیر را بررسی کنید:

• API Key صحیح باشد.

• Key منقضی یا غیرفعال نشده باشد.

• فاصله اضافی در ابتدا یا انتهای Key وجود نداشته باشد.

• API Key مربوط به سرویس دیگری را وارد نکرده باشید.

خطای 404

یکی از دلایل رایج 404 استفاده از Base URL اشتباه است.

برای OpenAI Compatible:

https://co.agentrouter.org/v1

و برای Anthropic Compatible:

https://co.agentrouter.org

استفاده می‌شود.

خطای Model Not Found

اگر با خطایی مانند:

model not found

مواجه شدید، Model ID را بررسی کنید.

ممکن است مدل موردنظر دیگر در Resource Pool مربوط به API Key شما موجود نباشد.

بنابراین بهتر است قبل از تنظیم مدل، لیست مدل‌های قابل دسترس را در پنل AgentRouter بررسی کنید.

چند نکته مهم امنیتی

API Key را مانند Password در نظر بگیرید.

هرگز آن را:

• داخل GitHub قرار ندهید.

• داخل Source Code عمومی قرار ندهید.

• در Screenshot منتشر نکنید.

• در اختیار افراد ناشناس قرار ندهید.

اگر API Key شما لو رفت، بهتر است آن را در پنل سرویس غیرفعال یا حذف کرده و یک Key جدید ایجاد کنید.

آیا AgentRouter کاملاً رایگان است؟

باید بین Free Quota و Unlimited Free API تفاوت قائل شویم.

طبق مستندات فعلی، AgentRouter برای توسعه‌دهندگان Free Quota ارائه می‌کند؛ این به معنی استفاده نامحدود و بدون هیچ محدودیتی از تمام مدل‌ها نیست. مقدار سهمیه، مدل‌های در دسترس و شرایط استفاده می‌تواند تغییر کند.

بنابراین بهتر است به‌جای اینکه بگوییم:

AgentRouter یک API کاملاً رایگان و نامحدود است.

بگوییم:

AgentRouter برای توسعه‌دهندگان سهمیه رایگان ارائه می‌کند که می‌توان از آن برای استفاده از مدل‌های هوش مصنوعی در ابزارهای مختلف استفاده کرد.

این عبارت دقیق‌تر است.

جمع‌بندی

برای استفاده از API رایگان AgentRouter معمولاً این مسیر را طی می‌کنیم:

1. ایجاد حساب
        ↓
2. دریافت API Key
        ↓
3. انتخاب Model
        ↓
4. تعیین API Format
        ↓
5. تنظیم Base URL
        ↓
6. اتصال به ابزار موردنظر
        ↓
7. ارسال اولین درخواست

اگر از OpenAI Compatible استفاده می‌کنید، مهم‌ترین تنظیمات فعلی عبارت‌اند از:

Base URL:
https://co.agentrouter.org/v1

API Key:
کلید دریافت‌شده از AgentRouter

Model:
مدل موجود در حساب شما

و اگر از مدل‌های Claude با Anthropic Compatible استفاده می‌کنید، Base URL باید بدون /v1 باشد.

به این ترتیب می‌توانید از یک API مشترک برای اتصال ابزارهای مختلف AI Coding استفاده کنید؛ بدون اینکه لازم باشد Source Code این ابزارها را تغییر دهید.