پرسش‌های پرتکرار دربارهٔ API هوش مصنوعی در ایران

هیبانا درگاه API هوش مصنوعی سازگار با OpenAI با پرداخت ریالی است. با یک حساب و یک کلید API به مدل‌های OpenAI، Anthropic (Claude)، Google (Gemini)، DeepSeek و مدل‌های دیگر دسترسی دارید و هزینه از کیف پول ریالی کم می‌شود. هیبانا خودش یک مدل نیست؛ برنامهٔ شما با هیبانا حرف می‌زند و ارتباط با ارائه‌دهندهٔ نهایی سمت ماست.

از طریق هیبانا و با همان کتابخانهٔ رسمی OpenAI؛ فقط آدرس پایه را https://api-ai.hibanacloud.ir/v1 بگذارید و کلید هیبانا را وارد کنید. مدل‌های GPT را با همان نام‌هایی صدا می‌زنید که در لیست مدل‌ها آمده است.

بله، از طریق هیبانا. API رسمی آنتروپیک از ایران در دسترس نیست، اما مدل‌های Claude (Haiku، Sonnet، Opus و Fable) را می‌توانید با کتابخانهٔ OpenAI و پرداخت ریالی از هیبانا صدا بزنید.

مدل‌های Gemini گوگل و DeepSeek هم در هیبانا هستند و با همان کلید و همان کد کار می‌کنند؛ فقط نام مدل عوض می‌شود.

نه. برنامهٔ شما فقط به هیبانا وصل می‌شود و ارتباط با ارائه‌دهنده‌های خارجی سمت هیباناست، پس نه VPN لازم دارید و نه پروکسی روی سرور.

نه؛ کیف پول حسابتان را با تومان و از درگاه بانکی شارژ می‌کنید و هزینهٔ هر درخواست از همان کیف پول کم می‌شود. برای هر ارائه‌دهنده حساب یا کارت جداگانه لازم ندارید.

اگر کد شما با API یا SDK اوپن‌ای‌آی نوشته شده، بله؛ فقط base_url و کلید عوض می‌شود. مسیرهای /v1/chat/completions، /v1/responses، /v1/embeddings و /v1/images/generations همان قرارداد استاندارد را دارند.

بیش از ۸۰ مدل گفت‌وگو و متن، ساخت تصویر، صدا و embedding از OpenAI، Anthropic، Google، DeepSeek و شرکت‌های دیگر. فهرست زنده با قیمت، پنجرهٔ متن و قابلیت هر مدل در صفحهٔ مدل‌ها است.

بر اساس مصرف واقعی: توکن‌های ورودی و خروجی، با قیمت هر مدل به‌ازای هر میلیون توکن. قیمت هر مدل به تومان در صفحهٔ همان مدل آمده است و هزینهٔ هر درخواست را در پاسخ API و داشبورد می‌بینید.

مدل‌های خارجی در زمان قطعی در دسترس نیستند، اما مدل‌هایی که روی سرورهای خود هیبانا اجرا می‌شوند (مثل openai/gpt-oss-20b برای گفت‌وگو و baai/bge-m3 برای embedding) کار می‌کنند. با همان کلید و همان کد فقط نام مدل را عوض می‌کنید.

در تنظیمات هر ابزار، ارائه‌دهندهٔ سازگار با OpenAI را انتخاب کنید و آدرس پایه، کلید هیبانا و نام مدل را وارد کنید. راهنمای تصویری هر ابزار در مستندات است.

محدودیت برای هر مدل جداگانه اعمال می‌شود و سقف آن به سطح حساب شما بستگی دارد: هر حساب از سطح ۱ شروع می‌کند و با مجموع شارژهای کیف پول خودکار به سطح‌های بالاتر می‌رسد. سطح فعلی و سقف هر مدل در تنظیمات داشبورد آمده است. اگر از سقف بگذرید پاسخ 429 می‌گیرید و باید کمی صبر کنید یا درخواست را دوباره بفرستید.

نه؛ هیبانا متن پیام‌های شما و پاسخ‌های مدل را جمع‌آوری و نگهداری نمی‌کند. برای صورت‌حساب فقط اطلاعات مصرف ثبت می‌شود: نام مدل، تعداد توکن‌ها، هزینه و زمان درخواست. پیام فقط برای ساختن پاسخ به ارائه‌دهندهٔ همان مدل فرستاده می‌شود (مدل‌های داخلی مثل openai/gpt-oss-20b روی سرورهای خود هیبانا اجرا می‌شوند). دو استثنای کوتاه‌مدت برای ارائهٔ سرویس هست: تصویر ساخته‌شده حدود یک ساعت نگه داشته می‌شود تا دانلودش کنید، و اگر سرآیند Idempotency-Key بفرستید، پاسخ ۲۴ ساعت نگه داشته می‌شود تا تکرار همان درخواست همان پاسخ را بگیرد.

حساب بسازید، از داشبورد یک کلید API بگیرید و اولین درخواست را با نمونه‌کد راهنمای شروع سریع بفرستید. نمونه‌کد پایتون، جاوااسکریپت، C# و جاوا در گیت‌هاب هیبانا هم هست.