Route Key: درگاه API هوش مصنوعی سازگار با OpenAI
مسیریابی هر درخواست.
درگاه API هوش مصنوعی سازگار با OpenAI
endpoint را عوض کنید، روند کاری را نگه دارید
شروع سریع
با یک کلید API و قالبهای سازگار با OpenAI شروع کنید.
استفاده از Route Key با عاملهای کدنویسیCodex · Claude Code · Gemini CLI · Cursorپیکربندی عاملهابدون تغییر کد برنامه از مسیرهای گران یا ناسالم فاصله بگیرید.
هنگام انتخاب کانال سالم، پاسخهای SSE را زنده نگه دارید.
پراکندگی کمتر و کنترل روشنتر ترافیک
curl https://api.routekey.ai/v1/chat/completions \
-H "Authorization: Bearer sk-route-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"routing": {
"policy": "cost_latency_health",
"fallback": ["deepseek-chat", "gemini-1.5-pro"]
},
"stream": true,
"messages": [
{ "role": "user", "content": "Route this by cost and latency." }
]
}'پیش از ورود درخواستها به درگاه
01Route Key چیست و به کدام مدلها متصل میشود؟
Route Key یک درگاه API سازگار با OpenAI و لایه کنترل مسیریابی است. مدلهای فعال در کاتالوگ، از جمله GPT، Claude، Gemini، DeepSeek، Qwen و کانالهای سفارشی سازگار را در اختیار میگذارد. پیش از ترافیک تولید، صفحه مدلها را برای مقایسه ارائهدهنده، زمینه، endpoint، گروه و شناسه دقیق مدل باز کنید.
02آیا Route Key با SDK و APIهای OpenAI سازگار است؟
در بیشتر موارد بله. قالب آشنای درخواست OpenAI و کد SDK را نگه دارید، Base URL را به endpoint سازگار Route Key تغییر دهید، کلید API را تنظیم کنید و مدل پشتیبانیشده را انتخاب کنید. ابتدا یک درخواست کوتاه بدون استریم را آزمایش کنید و سپس استریم، ابزار و زمینه طولانی را اضافه کنید.
03Route Key چگونه درخواستها را مسیریابی و هزینه API را کنترل میکند؟
درگاه مسیرهای موجود را با نسبت گروه، قیمت توکن ورودی و خروجی، کش، تأخیر و سلامت ارزیابی میکند. میتوانید مدل را ثابت کنید یا انتخاب مسیر سالم کمهزینه را به سیاست بسپارید. مدل، توکن، گروه و هزینه را در گزارش مصرف بررسی کنید تا صرفهجویی قابل اندازهگیری باشد.
04آیا میتوانم مصرف API، هزینه و گزارش درخواست را ببینم؟
بله. کلیدهای API در کنسول ماسک میشوند و گزارش مصرف وضعیت درخواست، مدل، هزینه، تعداد توکن ورودی و خروجی، تأخیر و زمان را طبق تنظیمات حریم خصوصی نشان میدهد. برای برنامهها یا عاملهای کدنویسی کلید جدا بسازید تا دسترسی را بهسادگی بچرخانید.
05آیا Route Key از failover و پاسخ استریم پشتیبانی میکند؟
انتخاب مسیر پیش از ارسال انجام میشود تا درگاه بتواند کانال ناسالم یا در دسترسنبودنی را کنار بگذارد. در endpointهای استریم، Route Key پاسخ SSE را هنگام انتخاب مسیر سالم حفظ میکند. پس از انتشار، تأخیر و خطا را بررسی و سیاست جایگزین تنظیم کنید.
06چطور Route Key را در محیط تولید شروع کنم؟
در داشبورد یک کلید API اختصاصی بسازید، SDK را به endpoint سازگار Route Key وصل کنید، شناسه دقیق مدل را انتخاب و یک درخواست کوچک ارسال کنید. پاسخ، سهمیه، endpoint، مصرف توکن، تأخیر و هزینه را در گزارش مصرف بررسی کنید و سپس استریم، همزمانی، retry و failover را مرحلهبهمرحله اضافه کنید.
هر درخواست را مسیریابی کنید.
با یک کلید API هزینه، سرعت و سلامت مدلها را مقایسه کنید.
endpoint را عوض کنید، روند کاری را نگه دارید
Route Key کد برنامه را از پراکندگی ارائهدهندگان جدا میکند: یک کلید، یک ورودی سازگار، قیمت زنده مدل، سیاست ارسال، کلیدهای ماسکشده، پیوستگی استریم و تلهمتری مصرف.
curl /v1/chat/completions \
-H "Authorization: Bearer sk-route-key" \
-d '{"model":"gpt-4o-mini","stream":true}'درخواستها یکبار وارد میشوند؛ سیاست بهترین مسیر را انتخاب میکند.
SDK قالب درخواست را حفظ میکند و Route Key داده کاتالوگ، قیمت کانال، پیوستگی استریم و راهکار failover را پشت درگاه مدیریت میکند.
پیش از ورود درخواستها به درگاه
01Route Key چیست و به کدام مدلها متصل میشود؟
Route Key یک درگاه API سازگار با OpenAI و لایه کنترل مسیریابی است. مدلهای فعال در کاتالوگ، از جمله GPT، Claude، Gemini، DeepSeek، Qwen و کانالهای سفارشی سازگار را در اختیار میگذارد. پیش از ترافیک تولید، صفحه مدلها را برای مقایسه ارائهدهنده، زمینه، endpoint، گروه و شناسه دقیق مدل باز کنید.
02آیا Route Key با SDK و APIهای OpenAI سازگار است؟
در بیشتر موارد بله. قالب آشنای درخواست OpenAI و کد SDK را نگه دارید، Base URL را به endpoint سازگار Route Key تغییر دهید، کلید API را تنظیم کنید و مدل پشتیبانیشده را انتخاب کنید. ابتدا یک درخواست کوتاه بدون استریم را آزمایش کنید و سپس استریم، ابزار و زمینه طولانی را اضافه کنید.
03Route Key چگونه درخواستها را مسیریابی و هزینه API را کنترل میکند؟
درگاه مسیرهای موجود را با نسبت گروه، قیمت توکن ورودی و خروجی، کش، تأخیر و سلامت ارزیابی میکند. میتوانید مدل را ثابت کنید یا انتخاب مسیر سالم کمهزینه را به سیاست بسپارید. مدل، توکن، گروه و هزینه را در گزارش مصرف بررسی کنید تا صرفهجویی قابل اندازهگیری باشد.
04آیا میتوانم مصرف API، هزینه و گزارش درخواست را ببینم؟
بله. کلیدهای API در کنسول ماسک میشوند و گزارش مصرف وضعیت درخواست، مدل، هزینه، تعداد توکن ورودی و خروجی، تأخیر و زمان را طبق تنظیمات حریم خصوصی نشان میدهد. برای برنامهها یا عاملهای کدنویسی کلید جدا بسازید تا دسترسی را بهسادگی بچرخانید.
05آیا Route Key از failover و پاسخ استریم پشتیبانی میکند؟
انتخاب مسیر پیش از ارسال انجام میشود تا درگاه بتواند کانال ناسالم یا در دسترسنبودنی را کنار بگذارد. در endpointهای استریم، Route Key پاسخ SSE را هنگام انتخاب مسیر سالم حفظ میکند. پس از انتشار، تأخیر و خطا را بررسی و سیاست جایگزین تنظیم کنید.
06چطور Route Key را در محیط تولید شروع کنم؟
در داشبورد یک کلید API اختصاصی بسازید، SDK را به endpoint سازگار Route Key وصل کنید، شناسه دقیق مدل را انتخاب و یک درخواست کوچک ارسال کنید. پاسخ، سهمیه، endpoint، مصرف توکن، تأخیر و هزینه را در گزارش مصرف بررسی کنید و سپس استریم، همزمانی، retry و failover را مرحلهبهمرحله اضافه کنید.