API سازگار با OpenAI
همان SDKها و کلاینتهای رایج را با Base URL پلتفرم استفاده کنید؛ chat, responses, embeddings, audio و video در یک مسیر استاندارد قرار دارند.
HM Gateway هوش مصنوعی داتکام
همه مدلهای هوش مصنوعی،با یک API در محصول شما
با همان OpenAI SDK به مدلهای متن، تصویر، صوت و ویدیو وصل شوید. مدیریت کلید، کیفپول، صورتحساب و مانیتورینگ هر درخواست را به یک زیرساخت فارسی و یکپارچه بسپارید.
Chat & ResponsesAudio & VideoUsage Billing
محیط توسعه Gateway
سرویس فعال
gateway-client.ts
01import OpenAI from 'openai'0203const client = new OpenAI({04 apiKey: process.env.HMAI_GATEWAY_API_KEY,05 baseURL: 'https://platform.hooshemasnoei.com/api/v1',06})0708const response = await client.chat.completions.create({09 model: 'openai/gpt-4o-mini',10 messages: [{ role: 'user', content: 'سلام!' }],11 stream: true,12})
۱۲+
مسیرهای سازگار با OpenAI
Real-time
پایش مصرف و هزینه
IRT → USD
پرداخت و شارژ
زیرساخت توسعهدهندگان
از ساخت کلید تا مانیتورینگ هزینه، یک جریان کامل برای تیم فنی
این محصول برای زمانی ساخته شده که میخواهید مدلهای هوش مصنوعی را به محصول خود اضافه کنید، اما نمیخواهید هر ارائهدهنده، صورتحساب، کلید و مانیتورینگ را جداگانه مدیریت کنید.
کیفپول و صورتحساب دقیق
اعتبار داخلی به دلار نگهداری میشود، پرداخت کاربر ریالی است و هر مصرف با تراکنش، لاگ و گزارش قابل پیگیری ثبت میشود.
مدیریت کلیدهای API
برای هر پروژه کلید جدا بسازید، quota مصرف بگذارید، کلید را revoke کنید و در صورت نیاز با OTP مقدار کلید را امن مشاهده کنید.
کاتالوگ مدلها و قابلیتها
مدلها، endpointها، modalityها، قیمتها و وضعیت فعال بودن از کاتالوگ داخلی همگامسازی میشوند و در داشبورد قابل بررسی هستند.
مانیتورینگ، خطا و سلامت سرویس
داشبوردهای usage، latency، error، هزینه، proxy mode و uptime کمک میکنند قبل از اثرگذاری روی کاربر مشکل را ببینید.
Management API برای اتوماسیون
برای تیم خود کلید مدیریتی read-only با scope محدود بسازید تا سیستمهای داخلی موجودی، مصرف و گزارشها را بخوانند.
OpenAI-Compatible Routes
یک Base URL برای متن، صدا، تصویر، ویدیو و کاتالوگ مدلها
مسیرهای عمومی برای توسعهدهندگان طراحی شدهاند تا با SDKهای رایج کار کنند و در عین حال billing، usage و امنیت کلیدها از سمت پلتفرم کنترل شود.
POSTChat
/api/v1/chat/completionsPOSTResponses
/api/v1/responsesPOSTEmbeddings
/api/v1/embeddingsPOSTSTT
/api/v1/audio/transcriptionsPOSTTTS
/api/v1/audio/speechPOSTVideo Jobs
/api/v1/videosGETModels
/api/v1/modelsGETHealth
/api/v1/healthاعتبار داخلی دلاری و پرداخت کاربر با تومان
ثبت تراکنش برای هر تغییر موجودی کیفپول
نمایش هزینه، توکن، latency و وضعیت هر درخواست
قیمتگذاری قابل تنظیم برای مدیران و مدلها
عدم شارژ کاربر در درخواستهای ناموفق پیش از billing
تسویه امن برای استریم، ویدیو و jobهای async
Financial Safety
برای APIهای مالیحساس، هزینه و موجودی باید قابل اعتماد باشد
HM Gateway فقط proxy نیست؛ کیفپول، قیمتگذاری، تراکنشها، لاگ مصرف و هشدارها کنار هم طراحی شدهاند تا تیم شما بداند هر درخواست چقدر هزینه داشته و چرا ثبت شده است.
USD
واحد داخلی هزینه
IRT
پرداخت و شارژ کاربر
Audit
ردیابی تراکنشها
Admin & Observability
کنترل عملیاتی برای روزهایی که سرویس شما زیر بار واقعی است
Usage Analytics
مصرف، هزینه، توکن و latency بر اساس مدل، کلید API و بازه زمانی.
Error Debugging
مشاهده الگوهای خطا، request id، وضعیت upstream و خطاهای کاربر.
Proxy System
پایش DIRECT، primary proxy، secondary proxy و مسیر فعال اتصال.
Wallet Auditing
تاریخچه کیفپول، پرداخت، adjustment، hold، debit و refund.
1
۱. کلید API بسازید
در داشبورد Gateway یک کلید پروژه بسازید. مقدار خام کلید فقط همان لحظه نمایش داده میشود و بعد از آن امن نگهداری میشود.
HMAI_GATEWAY_API_KEY=hmai_xxxxx
2
۲. Base URL را تغییر دهید
در OpenAI SDK فقط baseURL را به آدرس پلتفرم تغییر دهید. ساختار درخواستها تا حد ممکن OpenAI-compatible باقی میماند.
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.HMAI_GATEWAY_API_KEY,
baseURL: 'https://platform.hooshemasnoei.com/api/v1'
})3
۳. مصرف و هزینه را پایش کنید
داشبورد مصرف، نمودارها، request log، مدلها، هزینه، TTFT، latency و کلیدهای پرمصرف را نمایش میدهد.
سوالات رایج
پاسخهای کوتاه برای تصمیمگیری فنی و شروع سریع تیم شما.
آیا باید کدهای قبلی OpenAI SDK را بازنویسی کنم؟
در اکثر سناریوها فقط Base URL و API Key تغییر میکند. مسیرهای اصلی مثل chat/completions، responses، embeddings، audio و models برای استفاده با SDKهای رایج طراحی شدهاند.
پرداخت و موجودی چطور محاسبه میشود؟
کاربر با تومان شارژ میکند، سیستم اعتبار را بر اساس نرخ تبدیل تنظیمشده به دلار کیفپول تبدیل میکند و مصرف مدلها از اعتبار دلاری کسر میشود.
برای تیم فنی میتوانم دسترسی محدود بسازم؟
بله. Gateway API Key برای مصرف مدلهاست و Management API Key برای خواندن دادههایی مثل موجودی، مصرف و صورتحساب با scope محدود استفاده میشود.
آیا مسیرهای صوت، تصویر و ویدیو هم پشتیبانی میشوند؟
بله. علاوه بر متن، مسیرهای multimodal برای STT، TTS، embeddings، rerank، video job و کاتالوگ مدلها در مستندات عمومی پوشش داده شدهاند.
برای اولین درخواست API آمادهاید؟
یک کلید بسازید، موجودی کیفپول را شارژ کنید و با همان OpenAI SDK اولین درخواست را ارسال کنید.