دسترسی به API کلود (Claude) در ایران؛ Opus، Sonnet و Haiku با پرداخت ریالی
مدل‌های Claude آنتروپیک را از ایران و با پرداخت ریالی صدا بزنید؛ معرفی Opus، Sonnet و Haiku در هیبانا، قیمت با تخفیف فعلی و نمونه‌کد آزموده‌شدهٔ پایتون.
۶ دقیقه مطالعه
API هوش مصنوعی چیست و چطور از داخل ایران از آن استفاده کنیم؟
راهنمای ساده API هوش مصنوعی برای توسعه‌دهنده‌های ایرانی؛ از ساخت کلید و پرداخت ریالی تا اولین درخواست به GPT، Claude و Gemini با یک API سازگار با OpenAI.
تیم هیبانا۳ دقیقه مطالعه
اگر می‌خواهید در برنامه، سایت یا ربات خودتان از مدل‌هایی مثل GPT، Claude یا Gemini استفاده کنید، باید از API آن‌ها کمک بگیرید. این راهنما توضیح می‌دهد API هوش مصنوعی دقیقاً چیست، چرا استفادهٔ مستقیم از آن در ایران دردسر دارد و چطور در چند دقیقه اولین درخواست را بفرستید.
API هوش مصنوعی یعنی چه؟
API یک درگاه برنامه‌نویسی است: برنامهٔ شما یک متن (یا تصویر و فایل) را به سرور مدل می‌فرستد و پاسخ مدل را به‌صورت داده دریافت می‌کند. همان کاری که در صفحهٔ چت انجام می‌دهید، این بار از داخل کد شما و بدون دخالت دست انجام می‌شود.
با API می‌توانید مثلاً:
- یک چت‌بات پشتیبانی روی سایت خودتان راه بیندازید؛
- متن‌ها را خلاصه، ترجمه یا دسته‌بندی کنید؛
- به ابزارهای کدنویسی مثل Kilo Code یک مدل قوی وصل کنید؛
- روی اسناد خودتان جست‌وجوی معنایی و RAG بسازید.
هزینهٔ API بر اساس توکن حساب می‌شود، نه ماهانه؛ یعنی فقط به اندازهٔ مصرف واقعی پرداخت می‌کنید. جزئیاتش را در مطلب توکن و هزینه نوشته‌ایم.
چرا استفادهٔ مستقیم از داخل ایران سخت است؟
شرکت‌هایی مثل OpenAI و Anthropic به کاربران ایرانی سرویس نمی‌دهند. درخواست‌هایی که از ایران ارسال شوند معمولاً با خطای عدم پشتیبانی از منطقه رد می‌شوند و پرداخت دلاری هم بدون کارت بین‌المللی ممکن نیست.
اگر با خطایی مثل unsupported_country_region_territory یا خطای 403 از OpenAI روبه‌رو شده‌اید، مشکل از کد شما نیست؛ دسترسی از ایران مسدود است.
هیبانا چه کاری انجام می‌دهد؟
هیبانا یک درگاه واحد به مدل‌های هوش مصنوعی است:
- یک کلید برای همهٔ مدل‌ها: GPT، Claude، Gemini، DeepSeek و مدل‌های دیگر با همان کلید.
- سازگار با OpenAI: هر کد یا ابزاری که با OpenAI SDK کار می‌کند، فقط با عوض کردن آدرس پایه (
base_url) و کلید به هیبانا وصل می‌شود. - پرداخت ریالی: کیف پول را با کارت بانکی شارژ می‌کنید و هزینهٔ هر درخواست به ریال کسر می‌شود.
اولین درخواست در سه قدم
۱. ساخت کلید
وارد حساب کاربری شوید و از بخش کلیدهای وب‌سرویس یک کلید جدید بسازید. مراحل با تصویر در راهنمای دریافت کلید آمده است.
۲. شارژ کیف پول
یک مبلغ کوچک برای شروع کافی است. توصیه می‌کنیم اول با مبلغ کم تست کنید و بعد از اطمینان از کارکرد، مصرف جدی‌تر را شروع کنید.
۳. ارسال درخواست
آدرس پایهٔ API هیبانا https://api-ai.hibanacloud.ir/v1 است. نمونهٔ زیر را به زبان دلخواهتان اجرا کنید و به‌جای YOUR_API_KEY کلید خودتان را بگذارید:
curl https://api-ai.hibanacloud.ir/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-5-nano", "messages": [{"role": "user", "content": "سلام! یک لطیفه کوتاه بگو."}], "max_completion_tokens": 2000, "reasoning_effort": "low" }'کدام مدل را انتخاب کنیم؟
انتخاب مدل به کار شما بستگی دارد. یک قاعدهٔ سرانگشتی:
| نیاز | نوع مدل مناسب |
|---|---|
| کارهای ساده و پرتعداد (دسته‌بندی، خلاصه‌سازی کوتاه) | مدل‌های کوچک و ارزان مثل نسخه‌های nano و mini |
| چت‌بات عمومی و تولید محتوا | مدل‌های میان‌رده |
| کدنویسی و استدلال پیچیده | مدل‌های قوی مثل Claude Sonnet یا GPT کامل |
| جست‌وجوی معنایی و RAG | مدل‌های امبدینگ |
قیمت و مشخصات هر مدل در لیست مدل‌ها آمده و می‌توانید چند مدل را کنار هم مقایسه کنید.
جمع‌بندی
برای استفاده از API هوش مصنوعی در ایران لازم نیست کد جدیدی بنویسید: همان کدی که برای OpenAI نوشته می‌شود، با تغییر آدرس پایه و کلید روی هیبانا کار می‌کند. از شروع سریع مستندات شروع کنید و اگر سؤالی داشتید، از طریق تیکت با ما در تماس باشید.
مطالب مرتبط
دسترسی به API جمینای (Gemini) در ایران؛ مدل‌ها، قیمت و نمونه‌کد
مدل‌های Gemini گوگل را از ایران و با پرداخت ریالی صدا بزنید؛ معرفی مدل‌های متنی، تصویری و امبدینگ جمینای در هیبانا، قیمت هر کدام و نمونه‌کد آزموده‌شدهٔ پایتون.
۶ دقیقه مطالعه
استفاده از API هوش مصنوعی بدون VPN؛ هنگام قطعی اینترنت بین‌الملل چه کنیم؟
بدون VPN و کارت خارجی از GPT، Claude و Gemini استفاده کنید و بدانید هنگام قطعی اینترنت بین‌الملل کدام مدل‌ها کار می‌کنند؛ همراه با کد مسیر جایگزین به مدل داخلی.
۴ دقیقه مطالعه
با یک کلید به همه مدل‌ها وصل شوید
GPT، Claude، Gemini و ده‌ها مدل دیگر، با پرداخت ریالی و یک API سازگار با OpenAI.