یک کلید، یک endpoint، مدل‌های چند تامین‌کننده
مدل‌های OpenAI، Anthropic، Azure OpenAI و OpenRouter را با همان SDK همیشگی صدا بزنید؛ با مسیریابی و failover امن، بودجه و گزارش مصرف جدا برای هر اپ.
from openai import OpenAI
client = OpenAI(api_key=os.environ["PUL_API_KEY"], base_url="https://api.pul.example/v1")
r = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "سلام!"}])
print(r.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.PUL_API_KEY, baseURL: "https://api.pul.example/v1" });
const r = await client.chat.completions.create({ model: "gpt-4o-mini", messages: [{ role: "user", content: "سلام!" }] });
console.log(r.choices[0].message.content);curl https://api.pul.example/v1/chat/completions \
-H "Authorization: Bearer $PUL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "سلام!"}]}'آداپتورهای تامین‌کننده در درگاه
- OpenAI
- Anthropic
- Azure OpenAI
- OpenRouter
مسیر هر درخواست
درخواست شما پیش از رسیدن به مدل بررسی می‌شود و بعد از پاسخ، هزینه‌ی دقیق یک بار و فقط یک بار کسر می‌شود.
- ۱
اپ شما
با کلید همان اپ و SDK سازگار با OpenAI درخواست می‌فرستید.
- ۲
بررسی
اعتبار و دسترسی کلید، سقف نرخ، بودجه‌ی اپ و موجودی کیف پول پیش از اجرا بررسی و هزینه‌ی تخمینی رزرو می‌شود.
- ۳
مسیریابی
منبع بر اساس اولویت و وزن انتخاب می‌شود؛ اگر هنوز بایتی ارسال نشده باشد، failover امن به منبع بعدی.
- ۴
پاسخ و تسویه
پاسخ یا استریم برمی‌گردد و هزینه‌ی واقعی یک بار و فقط یک بار در دفترکل دوطرفه ثبت می‌شود.
برای تیم‌هایی که هزینه و پایداری برایشان مهم است
یک endpoint سازگار
کد فعلی با تغییر base URL و کلید کار می‌کند. پارامترهای پشتیبانی‌نشده بی‌صدا نادیده گرفته نمی‌شوند.
مسیریابی و failover
هر مدل می‌تواند چند منبع داشته باشد؛ انتخاب با اولویت، وزن یا سنجاق کردن تامین‌کننده با هدر.
کیف پول تومانی
مصرف از کیف پول سازمان کسر می‌شود؛ هر تراکنش در دفترکل دوطرفه و تغییرناپذیر ثبت می‌شود.
اپ‌های جدا
برای هر اپ کلیدها، بودجه و گزارش مصرف جداگانه.
مصرف شفاف
توکن، وضعیت، تاخیر و تامین‌کننده‌ی هر درخواست در داشبورد دیده می‌شود.
امنیت کلید
نمایش یک‌باره، نگه‌داری فقط هش، دسترسی‌های محدود (scope)، چرخش و ابطال فوری.
پلن‌ها: امکانات و سقف‌ها، جدا از اعتبار مصرف
پلن سازمان سقف نرخ درخواست، تعداد اپ، کلید و عضو و سطح پشتیبانی را تعیین می‌کند. مصرف از بسته‌ی توکن اپ و سپس از کیف پول کسر می‌شود. مقایسه‌ی پلن‌ها
پلن‌ها قیمت ثابتی در این صفحه ندارند؛ پلن فقط امکانات و سقف‌ها را تعیین می‌کند. هزینه‌ی مصرف بر اساس هر مدل و توکن‌های مصرف‌شده از بسته‌ی توکن اپ یا کیف پول کسر می‌شود. برآورد هزینه‌ی هر مدل را پس از ورود در شبیه‌ساز قیمت کیف پول ببینید؛ فهرست مدل‌ها در صفحه‌ی مدل‌ها و نحوه‌ی شروع در مستندات آمده است.
پرسش‌های رایج
آیا کد فعلی‌ام بدون تغییر کار می‌کند؟
برای عملیات‌های پشتیبانی‌شده، کافی است آدرس پایه و کلید را عوض کنید. پارامترهایی که پشتیبانی نمی‌شوند با خطای صریح رد می‌شوند.
چه مدل‌هایی در دسترس است؟
فهرست زنده‌ی مدل‌ها با قابلیت‌ها و طول context در صفحه‌ی مدل‌ها و از طریق /v1/models در دسترس است.
اگر تامین‌کننده قطع شود چه می‌شود؟
اگر مدل منبع دیگری داشته باشد و هنوز بخشی از پاسخ ارسال نشده باشد، درخواست به منبع سالم بعدی می‌رود. وسط استریم دوباره ارسال نمی‌شود تا دو بار هزینه گرفته نشود.
آیا متن درخواست‌ها ذخیره می‌شود؟
به‌صورت پیش‌فرض خیر؛ فقط متادیتا و میزان مصرف برای صورت‌حساب نگه‌داری می‌شود.