درگاه OpenAI پلاتونیا برای توسعه‌دهندگان: صدور کلید API اختصاصی، پرداخت ریالی و مدیریت کامل مصرف

معرفی درگاه OpenAI پلاتونیا

درگاه OpenAI پلاتونیا (گیت‌وی پلاتونیا) یک سرویس امن و مقیاس‌پذیر برای برنامه‌نویسان و سازندگان محصول است. بدون دردسرهای فنی و پرداخت‌های بین‌المللی، قابلیت‌های نسل جدید هوش مصنوعی (از مدل‌های متنی گرفته تا مدل‌های ساخت ویدیو مثل Sora-2 و Sora-2-pro) را به وب‌اپ و استارتاپ خود اضافه کنید. به‌جای استفاده مستقیم از APIهای OpenAI، در پلاتونیا برای پروژه خود کلید/کلیدهای API صادر می‌کنید و همان کلیدها را در وب‌اپ خود به‌کار می‌گیرید. تمام مصرف‌ها ثبت می‌شود، اعتبار شما قابل شارژ ریالی است و امنیت کلید نیز کاملاً حفظ می‌شود.

مزیت‌های کلیدی برای توسعه‌دهندگان و استارتاپ‌ها

–  پرداخت ریالی با کارت‌های شتاب: نیازی به پرداخت بین‌المللی، کارت ارزی یا چالش‌های شارژ مستقیم در OpenAI ندارید. همه‌چیز از داخل حساب کاربری شما در پلاتونیا و با صورتحساب شفاف انجام می‌شود.

–  صدور کلید API اختصاصی برای هر پروژه/کاربر: برای هر وب‌اپ یا مشتری خود کلید جداگانه بسازید تا مدیریت، رصد و قطع/وصل دسترسی‌ها ساده باشد.

– امکان استفاده از کلید در هاست‌های ایرانی و دامنه‌های .ir: کلید/کلیدهای صادر شده توسط این سرویس بدون نگرانی از تحریم‌ها روی سرورهای ایرانی قابل استفاده هستند.

توجه: در شرایط خاص، در صورت اعمال محدودیت‌های شدید در اینترنت بین‌الملل احتمال اختلال در سرویس وجود دارد.

–  پشتیبانی از سناریوهای ویدیویی Sora: با کلید API گیت‌وی پلاتونیا می‌توانید از مدل‌های ساخت ویدیو OpenAI (مانند sora-2 و sora-2-pro) استفاده کنید؛ ویدیوها در سطح هر کلید ایزوله می‌شوند، فقط صاحب همان کلید می‌تواند وضعیت، دانلود و حذف آن ویدیو را انجام دهد و تاریخچه ویدیوهای هر کلید از طریق حساب کاربری شما در پلاتونیا قابل رصد است.

–  محدودیت کمتر و ظرفیت بالاتر: با توجه به استفاده پلاتونیا از حساب‌های Tier 5 OpenAI، سقف‌های مصرف و نرخ دسترسی بازتر است. این یعنی احتمال محدودیت کمتر نسبت به حساب‌های ابتدایی.

– مدیریت دقیق هزینه و مصرف: برای هر کاربر/پروژه سقف اعتبار بگذارید، مصرف را به‌صورت شفاف ببینید و در صورت اتمام اعتبار، رفتار سرویس را کنترل کنید.

– تعریف دامنه‌های مجاز (Domain Allowlist): کلید هر وب‌اپ را به دامنه(های) مجاز خود محدود کنید تا جلوی سوءاستفاده در سایت‌های دیگر گرفته شود.

–  گزارش‌گیری و شفافیت: نمودار مصرف روزانه، لاگ درخواست‌ها، واحد مصرف خام (توکن یا ثانیه ویدیو) و «اعتبار مصرف‌شده» را در یک پنل ساده ببینید و تحلیل کنید. در پنل کاربر تمرکز روی «اعتبار مصرف‌شده» است تا محاسبه هزینه برای شما ساده‌تر باشد.

– انعطاف در مدل‌ها: از مدل‌های محبوب و به‌روز OpenAI مانند GPT-4o، GPT-4.1، gpt-4o-mini  و مدل‌های reasoning  مانند o1 و o3 و همینطور gpt-5 در سناریوهای مختلف استفاده کنید.

برای چه سناریوهایی ایده‌آل است؟

– راه‌اندازی سریع MVP با قابلیت‌های AI: بدون درگیری با زیرساخت و پرداخت بین‌المللی، ویژگی‌های هوشمند را به محصول خود اضافه کنید.

– SaaS و اپلیکیشن‌های چندمستاجره: برای هر مستاجر/کاربر نهایی کلید اختصاصی صادر کنید، سهمیه بدهید و مصرف را جداگانه مدیریت کنید.

– چت‌بات‌های پشتیبانی و فروش: دستیارهای مکالمه‌ای مبتنی بر GPT در وب‌سایت یا پنل کاربری خود راه‌اندازی کنید.

– تولید و پردازش محتوا: تولید توضیحات محصول، پست وبلاگ، خلاصه‌سازی و بازنویسی با کنترل هزینه و مدل.

–  ابزارهای درون‌سازمانی: خلاصه‌سازی ایمیل‌ها، تحلیل متن/سند، ایده‌پردازی و اتوماسیون‌های هوشمند برای تیم‌ها.

–  آژانس‌ها و فریلنسرها: ارائه سرویس‌های AI به مشتریان متعدد با کلیدهای تفکیک‌شده و گزارش‌گیری مستقل.

– چت‌بات‌های پشتیبانی و فروش: دستیارهای مکالمه‌ای مبتنی بر GPT در وب‌سایت یا پنل کاربری خود راه‌اندازی کنید.

– تولید ویدیو با Sora: ساخت ویدیوهای کوتاه تبلیغاتی، موشن برای شبکه‌های اجتماعی یا ویدیوی آموزشی از روی متن، تصویر مرجع یا اسکریپت.  

– ریمیکس و توسعه ویدیوهای موجود: با استفاده از قابلیت remix در Sora، نسخه‌های جدیدی از ویدیوهای موجود بسازید (مثلاً تغییر استایل، رنگ، یا برخی جزئیات صحنه) بدون اینکه برای عملیات ریمیکس دوباره شارژ شوید.  

– داشبوردهای مولتی‌تنت و ویدیویی: ارائه سرویس ساخت ویدیو به کاربران نهایی (SaaS و مارکت‌پلیس‌ها) با مدیریت تفکیک‌شده کلیدها و اعتبار.

– پرداخت آسان داخلی: شارژ اعتبار با کارت‌های شتاب و فاکتور شفاف به‌جای پرداخت ارزی.

– کنترل یکپارچه و حاکمیت: کلیدها، مدل‌ها و سقف‌ها را از یک پنل واحد برای همه پروژه‌ها مدیریت کنید.

– ظرفیت بالاتر (Tier 5): به‌دلیل استفاده پلاتونیا از حساب‌های سطح‌بالای OpenAI، با محدودیت‌های کمتری مواجه می‌شوید. با این حال، سقف‌ها بسته به مدل و سیاست‌های OpenAI متغیر است.

– امنیت سازمانی: کلیدهای کاربران نیز فقط برای همان دامنه‌های مجاز پذیرفته می‌شوند.

– عدم نیاز به سرورهای غیرایرانی

پشتیبانی از مدل‌ها

• مدل‌های محاوره‌ای و تولید متن: GPT-4o، GPT-4.1، gpt-4o-mini و مدل‌های مشابه برای چت‌بات‌ها، تولید و بازنویسی محتوا.  
• مدل‌های reasoning: خانواده o1 و o3 برای سناریوهای تحلیلی و استدلالی پیچیده‌تر.  
• مدل‌های ویدیویی Sora: مدل‌های ساخت ویدیو مانند sora-2 و sora-2-pro برای تولید ویدیو از متن، تصویر مرجع یا ریمیکس ویدیوهای قبلی. هزینه این مدل‌ها در گیت‌وی بر اساس «طول ویدیو (ثانیه) × اعتبار/ثانیه» محاسبه می‌شود، نه توکن متن.  
• مدل‌های جدید (مثل gpt-5): پشتیبانی از مدل‌های جدید OpenAI به‌صورت تدریجی و با فاصله کوتاه بعد از معرفی رسمی.  
• انعطاف در لیست مدل‌ها: می‌توانید در پنل مدیریت، مدل‌های مجاز را مطابق نیاز کسب‌وکار خود فعال/غیرفعال کنید و برای هر مدل ضریب هزینه جداگانه تعریف کنید.

نکته مهم درباره نرخ محدودیت‌ها (Rate Limits)

– ریت‌لیمیت‌ها توسط OpenAI تعیین می‌شوند و معمولاً بر اساس چند معیار اندازه‌گیری می‌شوند: تعداد درخواست در دقیقه (RPM)، توکن در دقیقه (TPM)، و همچنین سقف‌های روزانه.

– محدودیت‌ها به مدل انتخابی و سطح حساب وابسته‌اند؛ برخی مدل‌ها سقف‌های مشترک دارند.

– پاسخ‌های OpenAI معمولاً هدرهای مرتبط با ریت‌لیمیت را برمی‌گردانند (مانند x-ratelimit-remaining-requests و x-ratelimit-remaining-tokens) تا بتوانید سمت کلاینت رفتار بهینه داشته باشید.

– در مورد مدل‌های ویدیویی Sora نیز سقف‌های جداگانه‌ای بر اساس تعداد و مدت ویدیوها اعمال می‌شود که توسط OpenAI تعیین شده و گیت‌وی پلاتونیا آن‌ها را رعایت می‌کند.

– بهترین‌روش‌ها برای عبور روان‌تر از محدودیت‌ها:

– استفاده از backoff نمایی در صورت بروز خطاهای محدودیتی.

– تجمیع کارها در درخواست‌های کمتر در صورت امکان (batching).

– تنظیم واقع‌بینانه max tokens و مدیریت حجم پاسخ‌ها.

– صف‌بندی وظایف غیر فوری برای ساعات خلوت‌تر.

– محدودسازی معقول مصرف هر کاربر در بازه‌های زمانی (روزانه/هفتگی/ماهانه) برای جلوگیری از سوءاستفاده.

چگونه شروع کنم؟

– ثبت‌نام/ورود به پلاتونیا: به حساب کاربری خود وارد شوید و در پنل کاربری، وارد بخش سرویس API شوید.

–  ساخت کلید API: در داشبور سرویس API، برای وب‌اپ خود یک یا چند کلید اختصاصی بسازید.

– تعیین دامنه‌های مجاز: دامنه(های) وب‌اپ خود را ثبت کنید تا فقط از همان مبداها درخواست‌ها پذیرفته شوند.

– شارژ اعتبار ریالی: بسته اعتباری مناسب خود را با کارت‌های شتاب تهیه کنید. مصرف توکن‌ها از همین اعتبار کسر می‌شود. هر کاربر به محض عضویت، تعدادی توکن ریاگان به عنوان اعتبار هدیه دریافت می‌کند.

– استفاده در وب‌اپ: کلید اختصاصی پلاتونیا را در وب‌اپ خود قرار دهید و از درگاه امن برای اتصال به OpenAI استفاده کنید؛ چه برای مدل‌های متنی (چت، تولید متن) و چه برای مدل‌های ویدیویی Sora (ایجاد، لیست، وضعیت، ریمیکس و دانلود محتوا). تمام درخواست‌های chargeable و مصرف اعتبار در پنل شما قابل مشاهده و گزارش‌گیری است..

مکانیسم کسر اعتبار

– اعتبار در سطح «کاربر» مدیریت می‌شود و بین همه کلیدهای API او مشترک است؛ هر کلید مصرف کند، از موجودی کل کاربر کسر می‌شود.  

– قبل از ارسال درخواست به OpenAI، یک برآورد اولیه از مصرف انجام می‌شود؛ اگر انتظار می‌رود از باقیمانده اعتبار عبور کند، درخواست همان ابتدا بدون تماس با OpenAI و بدون کسر اعتبار رد می‌شود (خطای quota_would_be_exceeded).

– برای مدل‌های متنی (چت، تکمیل متن و…):  

• در پاسخ موفق OpenAI، تعداد توکن مصرف‌شده از فیلد `usage` خوانده می‌شود (و اگر در پاسخ نبود، بر اساس طول بدنه درخواست/پاسخ به‌صورت استاندارد تخمین زده می‌شود).
• بر اساس «ضریب هزینه مدل» هزینه مصرف محاسبه می‌شود؛ ضریب هزینه مدل‌ها بر اساس تعرفه‌های OpenAI تعیین شده است. معمولاً مدل‌های قوی‌تر ضریب بالاتری دارند. این ضرایب بر اساس قیمت انواع توکن‌های OpenAI و همچنین میزان مصرف منابع پلاتونیا، در بک‌اند پلاتونیا تعریف شده‌اند.  

– برای مدل‌های ویدیویی Sora (ایجاد ویدیو):  

• هزینه بر اساس «مدت ویدیو (seconds) × واحد اعتبار در هر ثانیه (per_second_units)» محاسبه می‌شود؛ این واحدها برای هر مدل (مثل sora-2 یا sora-2-pro) توسط پلاتونیا تنظیم شده‌اند.  
• قبل از ارسال درخواست، برآورد می‌شود که ویدیوی درخواستی چه مقدار اعتبار نیاز دارد؛ اگر این مقدار از سقف کل کاربر یا سقف هزینه تعریف‌شده برای آن کلید عبور کند، درخواست همان ابتدا رد می‌شود.  
• عملیات غیرمولد مثل لیست ویدیوها، گرفتن وضعیت، دانلود محتوا و ریمیکس (در تنظیمات فعلی) non‑chargeable هستند و از اعتبار شما کم نمی‌کنند، اما در صورت بروز خطا، رویداد برای شفافیت در لاگ‌ها ثبت می‌شود.  

– مقدار نهایی مصرف، بعد از اعمال ضریب هزینه، به‌صورت عدد صحیح (با گرد کردن رو به بالا) از اعتبار کاربر کم می‌شود؛ باقیمانده به‌صورت آنی به‌روزرسانی می‌گردد.  

– در هدرهای پاسخ گیت‌وی، جزئیات مصرف نمایش داده می‌شود؛ از جمله:  

• >   – `X-Tokens-Used` (واحد مصرف خام: توکن یا واحد داخلی محاسبه‌شده)  
• >   – `X-Deducted-Units` (مقدار نهاییِ کسر شده از اعتبار داخلی)  
• >   – `X-Cost-Credits` (اعتبار شارژشده)  
• >   – به‌همراه وضعیت سقف هزینه کلید (`X-Key-Cost-Used` و `X-Key-Cost-Cap`).

سئوالات متداول (FAWQ)

چرا پلاتونیا؟

– تمرکز بر تجربه توسعه‌دهندگان: از MVP تا محصول در مقیاس بالا، با حداقل اصطکاک.

– پرداخت ریالی و حذف پیچیدگی‌های ارزی: شارژ سریع با کارت‌های شتاب.

– امنیت و کنترل: کلیدها، مدل‌ها، دامنه‌ها و سقف‌ها در یک پنل یکپارچه.

– شفافیت و گزارش‌گیری: دید کامل روی مصرف، هزینه و بهینه‌سازی. – ظرفیت بالاتر مبتنی بر حساب‌های Tier 5: برای دسترسی روان‌تر به مدل‌ها و کاهش محدودیت‌های رایج.

از شما دعوت می‌کنیم…

همین حالا در پلاتونیا ثبت‌نام کنید، کلید API اختصاصی وب‌اپ خود را بسازید و هوش مصنوعی OpenAI را به‌صورت امن، مقیاس‌پذیر و مقرون‌به‌صرفه وارد محصولتان کنید. در ادامه، چت بات تست گیت وی را آورده‌ایم. برای تست، کلید API صادرشده توسط گیت وی OpenAI پلاتونیا را در فیلد «کلید API کاربر» وارد کنید و از چت‌بات استفاده کنید. در داشبورد سرویس API حتما در فیلد «دامنه‌های مجاز»، آدرس platonia.co را وارد کنید. می‌توانید با نصب افزونه‌ی چت‌بات تست (دانلود کنید)، این چت‌بات را روی وب‌سایت وردپرسی خود راه‌اندازی کنید.

تیم پلاتونیا، یک افزونه‌ی وردپرسی به نام «پلاتونیاوید» را نیز عرضه کرده است که توانایی ساخت ویدیو با استفاده از مدل‌های sora-2 و sora-2-pro را به طراحان وبسایت‌های وردپرسی می‌دهد. این افزونه علاوه بر کلید API مستقیم دریافتی از OpenAI، با کلید API گیت‌وی پلاتونیا نیز سازگار است.

اگر برای انتخاب مدل‌ها، طراحی سیاست‌های مصرف یا راه‌اندازی سرویس نیاز به مشاوره دارید، تیم پلاتونیا در کنار شماست.