صفحه اختصاصی Provider

Agnes AI API رایگان

اطلاعات Agnes AI: سهمیه رایگان، روش اتصال (متصل مستقیم) و پیش‌نیاز حساب (پیش‌نیاز حساب نامشخص) با منبع و تاریخ بررسی.

متصل مستقیمآخرین بررسی: 2026-07-24

خلاصه فنی

نوع سهمیه: مدل‌های رایگان
محدودیت نمونه: 20 RPM
سازگار با OpenAI: بله
روش اتصال از ایران: متصل مستقیم
پیش‌نیاز حساب: پیش‌نیاز حساب نامشخص
Base URL: https://apihub.agnes-ai.com/v1

قابلیت‌ها

مدل‌های شاخص

agnes-2.0-flash، agnes-1.5-flash، agnes-image-2.0-flash، agnes-image-2.1-flash، agnes-video-v2.0

نکات مهم

پنج مدل عمومی در خانواده‌های متن، تصویر و ویدئو مستند شده‌اند. محدودیت‌ها مقادیر مرجع جاری‌اند و تضمین دائمی نیستند. طرح رایگان نیاز به کارت بانکی ندارد؛ طرح‌های اشتراکی (Starter $4، Plus $10، Pro $50) نیازمند پرداخت هستند.

اسناد رسمی Agnes میان Public Request RPM و Actual Executable RPM تفاوت می‌گذارند؛ Catalog مقدار قابل اجرای واقعی را ثبت می‌کند. Context window 256K و max output 64K بر اساس مستندات 2026-06-28 تأیید شده است. طرح‌های اشتراکی (Starter $4، Plus $10، Pro $50) با سهمیه‌های مشخص در مستندات رسمی اضافه شده‌اند.

درخواست احراز هویت‌شده با مدل agnes-2.0-flash از ایران با HTTP 200 پاسخ داده است. مدل از نوع reasoning و نتیجه استنتاج در فیلد reasoning_content قرار می‌گیرد. کلید API در سرور خارج (آلمان) نیز تأیید شده است. این نتیجه فقط برای ASN مسیر تست‌شده معتبر است.

هدف استفاده و نیت جست‌وجو

Agnes AI یک Gateway رسمی و سازگار با OpenAI برای متن، تصویر و ویدئو است که چند مدل عمومی با محدودیت‌های متفاوت ارائه می‌کند. این راهنما ساخت API Key، ارسال درخواست متنی اولیه و تفاوت میان Public Request RPM و ظرفیت واقعاً قابل اجرا را توضیح می‌دهد. وضعیت پرداخت و موفقیت inference مستقیم از ایران هنوز قطعی نیست و Reachability پاسخ 401 به‌تنهایی موفقیت مدل را ثابت نمی‌کند.

مراحل ثبت‌نام

در پلتفرم Agnes AI حساب بسازید و از Settings → API Keys یک کلید جدید ایجاد کنید. نیاز یا عدم نیاز به روش پرداخت را از Dashboard همان حساب کنترل کنید، زیرا در منابع رسمی بررسی‌شده صریح و قطعی ثبت نشده است.
کلید را فقط در متغیر محیطی AGNES_API_KEY یا secret manager نگهداری کنید. کلید را داخل frontend، مخزن، Notebook عمومی، screenshot یا log قرار ندهید و برای هر محیط کلید جدا بسازید.
مدل را از Model Catalog رسمی انتخاب کنید و محدودیت Actual Executable RPM همان نوع خروجی را بخوانید. Public Request RPM فقط نرخ پذیرش اولیه است و الزاماً به همان تعداد اجرای موفق تبدیل نمی‌شود.

نمونه اولین درخواست API

curl https://apihub.agnes-ai.com/v1/chat/completions \
  -H "Authorization: Bearer $AGNES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"agnes-2.0-flash","messages":[{"role":"user","content":"سلام! در یک جمله پاسخ بده."}],"stream":false}'

مدل نمونه در Catalog رسمی فعلی ثبت شده است. فهرست مدل‌ها، context window و محدودیت اجرای واقعی پویا هستند؛ پیش از استفاده، Model Catalog و Dashboard حساب را دوباره بررسی کنید.

منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16

خطاهای رایج و رفع اشکال

401/403 — API Key ارسال نشده یا حساب اجازه دسترسی ندارد
وجود AGNES_API_KEY و هدر Bearer را بررسی کنید، کلید افشاشده را rotate کنید و وضعیت حساب را در پلتفرم ببینید. پاسخ 401 endpoint از ایران فقط Reachability و نیاز به احراز هویت را نشان می‌دهد. منبع رسمی (2026-07-16)
404/model — مدل حذف شده یا شناسه نادرست است
شناسه مدل را از Model Catalog رسمی کپی کنید و به نمونه‌های قدیمی یا نام‌های cache‌شده تکیه نکنید. مدل‌های متن، تصویر و ویدئو endpoint و پارامترهای یکسانی ندارند. منبع رسمی (2026-07-16)
429/capacity — نرخ درخواست یا ظرفیت اجرای واقعی پر شده است
Actual Executable RPM همان مدل و کیفیت خروجی را مبنا قرار دهید، concurrency را کم و retry را با backoff و jitter اجرا کنید. رسیدن درخواست به Public RPM تضمین اجرای موفق نیست. منبع رسمی (2026-07-16)

چه زمانی این Provider انتخاب مناسبی نیست؟

زمانی که پروژه به سرویس قطعاً بدون روش پرداخت نیاز دارد؛ وضعیت payment requirement در منابع رسمی فعلی صریح نیست و باید در حساب واقعی بررسی شود.
زمانی که inference مستقیم تأییدشده از ایران شرط انتخاب است؛ Evidence فعلی فقط پاسخ احراز هویت endpoint را ثبت کرده و درخواست مدل با کلید معتبر انجام نشده است.
زمانی که workload به context ثابت، مدل دائمی یا ظرفیت تضمین‌شده برای متن، تصویر یا ویدئو نیاز دارد؛ Catalog و محدودیت‌ها پویا هستند.

راهنماهای مرتبط

آخرین بازبینی محتوای این صفحه: 2026-07-16

منابع بررسی

APIهای مرتبط

ساخت اولین درخواست مشاهده مستندات مقایسه با سایر APIها