نشانی پایه درگاه
نشانی فضای کاری که درخواستهای سازگار با OpenAI را دریافت میکند. مقدار معمولاً با `/v1` پایان مییابد.
https://YOUR_WORKSPACE.godarai.ir/v1راهنمای مرتبطمستندات گدارAI
گدارAI (GodarAI) یک درگاه مدلهای زبانی (LLM Gateway) است که بهعنوان لایه میانی بین اپلیکیشنهای شما و ارائهدهندگان مدلهای هوش مصنوعی عمل میکند.
با استفاده از گدارAI میتوانید تنها از طریق یک API سازگار با استاندارد OpenAI به صدها مدل و ارائهدهنده مختلف مانند OpenAI، Anthropic، Google Gemini، Azure OpenAI و AWS Bedrock متصل شوید، بدون آنکه وابستگی مستقیمی به هر ارائهدهنده داشته باشید.
گدارAI امکاناتی مانند مدیریت کلیدهای API، مسیریابی هوشمند درخواستها، پایش مصرف، کنترل هزینهها، حافظه نهان پاسخها، سیاستهای امنیتی و حاکمیتی، و مدیریت یکپارچه مدلها را در اختیار تیمهای توسعه و سازمانها قرار میدهد.
شروع بر اساس هدف
سه مسیر پرتکرار برای ورود به مستندات
اگر دقیق نمیدانید کدام صفحه را باید باز کنید، یکی از این مسیرها شما را به نزدیکترین راهنمای عملی میرساند.
مسیر پیشنهادی
اولین درخواست را بفرستید
فضای کاری، حساب ارائهدهنده، توکن دسترسی و شناسه مدل را آماده کنید و یک درخواست Chat Completions از مسیر گدارAI بفرستید.
شروع سریعانتخاب قراردادAPI مناسب را پیدا کنید
قراردادهای متن، داده، تصویر و صوت را بر اساس کاری که اپلیکیشن شما انجام میدهد بررسی کنید.
دیدن APIهامدل ذهنیمعماری درگاه را بفهمید
جایگاه گدارAI میان اپلیکیشن، ارائهدهنده مدل، مدل مجازی، کنترل هزینه و دادههای پایش را ببینید.
خواندن معماریقبل از نمونهکد
سه مقدار لازم برای اولین درخواست
بیشتر خطاهای شروع از همین سه مقدار میآیند. آنها را از فضای کاری خودتان بردارید و در نمونهکد جایگزین کنید.
توکن دسترسی
برای تست انسانی از PAT استفاده کنید. برای سرویسها و محیط عملیاتی، VAT انتخاب مناسبتری است.
YOUR_GODARAI_TOKENراهنمای مرتبطشناسه مدل
شناسه را از مدلهای مجاز فضای کاری یا مدل مجازی بردارید. شناسه مدل را از روی نام عمومی مدل حدس نزنید.
YOUR_MODEL_IDراهنمای مرتبطنقشه مستندات
دستهبندی موضوعی
برای تسلط هرچه سریعتر بر گدارAI این دسته از موضوعات اهمیت ویژهای دارند.
شروع و نمای کلی
شناخت محصول، مسیر شروع و انتخاب صفحه بعدی.
درگاه، مدلها و اتصال
اتصال حساب ارائهدهنده، مدل مجازی، احراز هویت و ارسال درخواست.
APIهای پشتیبانیشده
قراردادهای سازگار با OpenAI برای متن، داده، تصویر و صوت.
رجیستری پرامپت
ساخت، نسخهبندی و اجرای پرامپتهای قابل استفاده مجدد.
کاربران و دسترسی
کاربران، تیمها، نقشها، PAT، VAT و چرخه عمر کلیدها.
کنترل مصرف
حافظه نهان، محدودیت نرخ درخواست و محدودیت بودجه.
مالی
کیف پول، BYOK، قیمتگذاری سفارشی، تسویه، فاکتور و رهگیری هزینه.
گاردریلها
کنترل محتوای ورودی و خروجی، داده حساس و اعتبارسنجی قالب.
مشاهدهپذیری و پایش
گزارش رخداد، رد درخواست، سنجههای مدل و OpenTelemetry.
کمک سریع
به مشکلی خوردهاید؟ احتمالاً مشکل شما یکی از اینهاست.
درخواست، خطای احراز هویت دارد
توکن باید در خود گدارAI ساخته شده باشد. کلید خام ارائهدهنده مدل را بهعنوان توکن گدارAI نفرستید.
شناسه مدل یا مسیر API روشن نیست
ابتدا نوع API را انتخاب کنید، سپس شناسه مدل را از مدلهای مجاز یا مدل مجازی بردارید.
میخواهید نتیجه را بررسی کنید
بعد از ارسال درخواست، گزارش رخداد، رد درخواست و سنجهها نشان میدهند چه اتفاقی افتاده است.