دسترسی به API کلود (Claude) در ایران؛ Opus، Sonnet و Haiku با پرداخت ریالی

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

هیبانا یک درگاه سازگار با OpenAI است: برنامهٔ شما به آدرس https://api-ai.hibanacloud.ir/v1 درخواست می‌فرستد و هزینه از کیف پول ریالی کم می‌شود. برای Claude به SDK جداگانهٔ آنتروپیک نیاز ندارید؛ همان کتابخانهٔ openai کافی است و فقط نام مدل را عوض می‌کنید. اگر تازه شروع کرده‌اید، اول راهنمای API هوش مصنوعی و دریافت کلید API را ببینید.

فهرست زیر از کاتالوگ زندهٔ هیبانا خوانده شده است. در زمان نگارش این مطلب، روی همهٔ مدل‌های Claude در هیبانا ۵۰ درصد تخفیف برای ورودی و خروجی فعال است. طبق همان API، تخفیف Claude Fable 5.1 تا ۱ آبان ۱۴۰۵ است؛ برای بقیهٔ مدل‌ها تاریخ پایانی ثبت نشده و تخفیف برای مدت محدود است. قیمت‌ها به تومان و برای هر یک میلیون توکن‌اند؛ عدد اول قیمت با تخفیف است و عدد داخل پرانتز قیمت اصلی.

نسخه‌های قبلی هم در دسترس‌اند:

• Claude Fable 5 با همان قیمت Fable 5.1؛
• Opus 5، Opus 4.8، Opus 4.7، Opus 4.6 و Opus 4.5 با ورودی ۹۲۴٬۰۰۰ و خروجی ۴٬۶۲۰٬۰۰۰ تومان (پیش از تخفیف ۱٬۸۴۸٬۰۰۰ و ۹٬۲۴۰٬۰۰۰)؛
• Sonnet 5، Sonnet 4.6 و Sonnet 4.5 با ورودی ۵۵۴٬۰۰۰ و خروجی ۲٬۷۷۲٬۰۰۰ تومان (پیش از تخفیف ۱٬۱۰۹٬۰۰۰ و ۵٬۵۴۴٬۰۰۰).

پنجرهٔ متن Opus 4.5 و Sonnet 4.5 مثل Haiku 4.5 دویست هزار توکن است و بقیه یک میلیون توکن. طبق کاتالوگ، همهٔ این مدل‌ها متن و تصویر را ورودی می‌گیرند، خروجی متنی می‌دهند و از فراخوانی تابع (Function Calling)، حالت JSON و استریم پشتیبانی می‌کنند. قیمت‌ها و تخفیف‌ها ممکن است تغییر کنند؛ وضعیت به‌روز را در مدل‌های تخفیف‌دار Claude و صفحهٔ Claude در هیبانا ببینید.

آنتروپیک در صفحهٔ معرفی مدل‌ها نسل فعلی را این‌طور معرفی می‌کند: Haiku 5.5 سریع‌ترین مدل و مناسب کارهای پرحجم و حساس به تأخیر مثل دسته‌بندی، استخراج داده و مسیریابی درخواست‌هاست؛ Sonnet 5.5 بهترین ترکیب سرعت و هوش را دارد؛ Opus 5.5 برای کدنویسی عامل‌محور طولانی و کارهای دانشی است و برای بیشتر کارها نقطهٔ شروع پیشنهادی آنتروپیک است؛ Fable 5.1 کندتر است و برای استدلال سنگین و کارهای عامل‌محور خیلی طولانی ساخته شده است. با این توصیف و قیمت‌های بالا، یک قاعدهٔ سرانگشتی:

• دسته‌بندی پیام، استخراج فیلد و خلاصه‌سازی پرتعداد: Haiku 5.5. ارزان‌ترین مدل Claude در هیباناست.
• چت‌بات، تولید محتوا و کدنویسی روزمره: Sonnet 5.5.
• ایجنت‌های کدنویسی و کارهای چندمرحله‌ای سنگین: Opus 5.5.
• مسئله‌هایی که با Opus هم به نتیجهٔ دلخواه نمی‌رسند: Fable 5.1.

برای اینکه تفاوت هزینه ملموس شود، یک درخواست فرضی با ۲٬۰۰۰ توکن ورودی و ۵۰۰ توکن خروجی را با قیمت‌های بالا حساب کنیم: با Haiku 5.5 حدود ۸۲ تومان، با Sonnet 5.5 حدود ۱٬۶۶۴ تومان، با Opus 5.5 حدود ۳٬۳۲۶ تومان و با Fable 5.1 حدود ۸٬۳۱۶ تومان می‌شود. این حساب فقط تقریبی است، چون تعداد واقعی توکن خروجی را از پیش نمی‌دانید. بهترین راه انتخاب، آزمایش یک نمونهٔ واقعی روی دو مدل و مقایسهٔ کیفیت و هزینه است؛ مشخصات را هم در مقایسهٔ Sonnet 5.5 و Opus 5.5 کنار هم ببینید.

کتابخانه را با pip install openai نصب کنید. کد همان کد همیشگی OpenAI است و فقط base_url، کلید و نام مدل فرق می‌کند. ما این نمونه را با Claude Haiku 4.5 اجرا کردیم؛ برای مدل دیگر فقط مقدار model را عوض کنید:

from openai import OpenAI client = OpenAI(    base_url="https://api-ai.hibanacloud.ir/v1",    api_key="YOUR_API_KEY",) response = client.chat.completions.create(    model="anthropic/claude-haiku-4.5",    messages=[        {"role": "system", "content": "کوتاه و به فارسی پاسخ بده."},        {"role": "user", "content": "در دو جملهٔ کوتاه بگو Claude Haiku برای چه کارهایی مناسب است."},    ],    max_tokens=500,) print(response.choices[0].message.content)print(response.choices[0].finish_reason)print(response.usage)

خروجی در اجرای ما:

Claude Haiku برای کارهایی مناسب است که **سرعت و هزینه کم** مهم باشند، مثل پاسخ‌دهی سریع به سوالات ساده و تجزیه‌کننده متون کوتاه. این مدل برای کارهایی که **دقت بالا و استدلال عمیق** لازم است، مناسب نیست.stopCompletionUsage(completion_tokens=125, prompt_tokens=62, total_tokens=187, completion_tokens_details=None, prompt_tokens_details=None, cost_rial=1270)

فیلد cost_rial هزینهٔ واقعی همین درخواست است: ۱٬۲۷۰ ریال، یعنی ۱۲۷ تومان. این عدد با جدول بالا مطابقت دارد: ۶۲ توکن ورودی و ۱۲۵ توکن خروجی با قیمت تخفیف‌خوردهٔ Haiku 4.5. دو نکته هم در خروجی دیده می‌شود: Claude پاسخ را با قالب Markdown (ستاره‌ها) نوشته است، پس اگر متن را در جایی نشان می‌دهید که Markdown را نمایش نمی‌دهد، در پرامپت صریح بخواهید متن ساده بنویسد. مقدار finish_reason هم stop است، یعنی پاسخ کامل شده است. در یکی از اجراهای اول ما، با سقف ۳۰۰ توکن و سؤالی طولانی‌تر، پاسخ وسط جمله قطع شد؛ اگر finish_reason برابر length بود، max_tokens را بیشتر کنید. برای جزئیات محاسبهٔ هزینه توکن چیست و هزینهٔ API چطور حساب می‌شود را بخوانید.

برای چت‌بات بهتر است پاسخ را همان‌طور که تولید می‌شود نشان دهید. با stream=True تکه‌ها یکی‌یکی می‌رسند و با include_usage در پایان، مصرف و هزینه هم برمی‌گردد:

from openai import OpenAI client = OpenAI(base_url="https://api-ai.hibanacloud.ir/v1", api_key="YOUR_API_KEY") stream = client.chat.completions.create(    model="anthropic/claude-haiku-4.5",    messages=[{"role": "user", "content": "یک جملهٔ خوشامدگویی کوتاه برای کاربر تازهٔ یک فروشگاه اینترنتی بنویس."}],    stream=True,    stream_options={"include_usage": True},) for chunk in stream:    if chunk.choices and chunk.choices[0].delta.content:        print(chunk.choices[0].delta.content, end="", flush=True)    if chunk.usage:        print("\n", chunk.usage)

خروجی در اجرای ما:

# خوش آمدید! 🎉 به خانوادهٔ ما خوش آمدید! ما خوشحالیم که شما را در اینجا می‌بینیم. امیدواریم تجربهٔ خریدتان لذت‌بخش و راحت باشد. اگر سوالی داشتید، ما همیشه آماده کمک هستیم. 😊 CompletionUsage(completion_tokens=129, prompt_tokens=59, total_tokens=188, completion_tokens_details=None, prompt_tokens_details=None, cost_rial=1301)

ما «یک جمله» خواسته بودیم و مدل یک تیتر و دو بند نوشت. اگر قالب و طول پاسخ برایتان مهم است، آن‌ها را دقیق و با مثال در پیام system مشخص کنید. جزئیات فنی استریم، از جمله خط‌های keep-alive، در مستندات استریم آمده است.

همهٔ مدل‌های Claude در هیبانا تصویر را به‌عنوان ورودی می‌پذیرند و طبق مستندات ورودی فایل، فایل PDF هم روی مدل‌های claude-* کار می‌کند. یعنی می‌توانید یک فاکتور، قرارداد یا گزارش را همراه پیام بفرستید و از مدل بخواهید خلاصه کند یا فیلدهایش را به JSON برگرداند. ساختار ارسال تصویر در مستندات تصویر آمده و نمونهٔ کامل خواندن فاکتور را در مطلب API جمینای نوشته‌ایم؛ همان کد با تغییر نام مدل برای Claude هم کار می‌کند.

• قطعی اینترنت بین‌الملل: Claude روی سرورهای خارج از ایران اجرا می‌شود و وقتی ارتباط بین‌الملل قطع است، در دسترس نیست. برای این روزها یک مدل داخلی جایگزین در نظر بگیرید؛ روش کار را در استفاده از API هوش مصنوعی بدون VPN نوشته‌ایم.
• ویژگی‌های اختصاصی آنتروپیک: در هیبانا با رابط سازگار با OpenAI کار می‌کنید. پارامترهایی که فقط در API اختصاصی آنتروپیک تعریف شده‌اند، لزوماً در این رابط وجود ندارند؛ پیش از تکیه بر یک ویژگی خاص، آن را در مستندات هیبانا بررسی و آزمایش کنید.
• سقف درخواست: کاتالوگ برای مدل‌های Claude سقف پیش‌فرض ۵ درخواست در هر ۶۰ ثانیه را نشان می‌دهد. اگر خطای ۴۲۹ گرفتید، مستندات محدودیت نرخ را ببینید.
• قیمت و تخفیف ثابت نیستند: اعداد این مطلب مربوط به زمان نگارش‌اند. همیشه صفحهٔ هر مدل در لیست مدل‌ها را ملاک بگذارید.

برای استفاده از Claude در ایران به VPN یا کارت خارجی نیاز ندارید: با یک کلید هیبانا و کتابخانهٔ openai، از Haiku ارزان برای کارهای پرتعداد تا Opus و Fable برای کارهای سنگین را صدا می‌زنید و هزینه را به ریال می‌پردازید. برای شروع، کلید API بگیرید، اولین درخواست را با Claude Sonnet 5.5 یا Claude Haiku 5.5 بفرستید و اگر می‌خواهید Claude را در ابزار کدنویسی‌تان به کار بگیرید، راهنمای اتصال ایجنت‌های کدنویسی را ببینید.