API Claude در ایران، سازگار با Anthropic و OpenAI
Claude خانوادهی مدلهای زبانی Anthropic است که در کدنویسی، نوشتن متن طولانی و پیروی از دستورهای دقیق شناخته میشود. نسخههای Haiku سریع و اقتصادیاند، Sonnet توازن کیفیت و هزینه دارد و Opus برای سختترین کارهاست.
هوشوانا هم endpoint سازگار با Anthropic Messages دارد و هم سازگار با OpenAI. پس Claude Code و SDK رسمی Anthropic بدون تغییر کد وصل میشوند و اگر کدتان با SDK OpenAI نوشته شده، همان را با شناسهی مدل Claude صدا میزنید.
قیمت API Claude به تومان
قیمت دلاری سازنده ضرب در نرخ دلار هوشوانا (بهروزشده در ۲۲ مهر ۱۴۰۵). فقط به اندازهی توکن مصرفی پرداخت میکنید.
| مدل | نوع | کانتکست | قیمت ورودی | قیمت خروجی | کیفیت فارسی |
|---|---|---|---|---|---|
| Claude Sonnet 5.5anthropic/claude-sonnet-5.5 | متن | ۱ میلیون توکن | ۵۹۰٬۰۰۰ تومان | ۲٬۹۵۰٬۰۰۰ تومان | ۵ از ۵ |
| Claude Opus 5.5anthropic/claude-opus-5.5 | متن | ۱ میلیون توکن | ۱٬۱۸۰٬۰۰۰ تومان | ۵٬۹۰۰٬۰۰۰ تومان | ۵ از ۵ |
| Claude Haiku 5.5anthropic/claude-haiku-5.5 | متن | ۱ میلیون توکن | ۲۹٬۵۰۰ تومان | ۱۴۷٬۵۰۰ تومان | ۵ از ۵ |
| Claude Fable 5.1anthropic/claude-fable-5.1 | متن | ۱ میلیون توکن | ۲٬۹۵۰٬۰۰۰ تومان | ۱۴٬۷۵۰٬۰۰۰ تومان | ۵ از ۵ |
| Claude Sonnet 4.6anthropic/claude-sonnet-4.6 | متن | ۱ میلیون توکن | ۸۸۵٬۰۰۰ تومان | ۴٬۴۲۵٬۰۰۰ تومان | ۵ از ۵ |
| Claude Haiku 4.5anthropic/claude-haiku-4.5 | متن | ۲۰۰ هزار توکن | ۲۹۵٬۰۰۰ تومان | ۱٬۴۷۵٬۰۰۰ تومان | ۴ از ۵ |
قیمت مدلهای متنی و Embedding برای هر یک میلیون توکن است. مدلهای تصویر برای هر تصویر، گفتار به متن برای هر دقیقه و متن به گفتار برای هر یک میلیون کاراکتر حساب میشوند.
هزینهی تقریبی کارهای رایج
برآورد با توکنهای میانگین هر کار. عدد دقیق هر درخواست را در لاگ داشبورد میبینید، یا متن خودتان را در شمارندهی توکن بسنجید.
| مدل | یک پیام کوتاه چتبات | یک مقالهی ۱۵۰۰ کلمهای فارسی | خلاصهی یک سند ۲۰ صفحهای |
|---|---|---|---|
| Claude Haiku 4.5سریع و اقتصادی | ۵۴۶ تومان | ۵٬۲۸۱ تومان | ۵٬۶۰۵ تومان |
| Claude Sonnet 4.6متعادل | ۱٬۶۳۷ تومان | ۱۵٬۸۴۲ تومان | ۱۶٬۸۱۵ تومان |
| Claude Sonnet 5.5نسل جدید Sonnet | ۱٬۰۹۲ تومان | ۱۰٬۵۶۱ تومان | ۱۱٬۲۱۰ تومان |
| Claude Opus 5.5قویترین | ۲٬۱۸۳ تومان | ۲۱٬۱۲۲ تومان | ۲۲٬۴۲۰ تومان |
چرا API مستقیم Claude از ایران کار نمیکند؟
Anthropic ایران را جزو مناطق پشتیبانیشدهی API و Claude.ai ندارد. ساخت حساب، تأیید شماره و پرداخت اعتبار هم به ابزارهای خارجی نیاز دارد که برای کاربران ایرانی در دسترس نیست.
هوشوانا این مشکل را از سمت سرور حل میکند: درخواست شما به سرور هوشوانا در ایران میرسد، به مدل اصلی سازنده فرستاده میشود و پاسخ همان مدل برمیگردد. پرداخت ریالی است و احراز هویت لازم نیست.
کدام مدل Claude را انتخاب کنم؟
- پاسخ سریع و حجم بالا: Claude Haiku برای چتبات، خلاصهسازی و استخراج داده با هزینهی کم مناسب است.
- کدنویسی روزمره: Claude Sonnet انتخاب اصلی بیشتر تیمها برای Claude Code و ویرایش چندفایلی است.
- مسئلههای سخت: Claude Opus را برای معماری، تحلیل پیچیده و کارهایی نگه دارید که دقت از هزینه مهمتر است.
اتصال به API Claude در سه قدم
ثبتنام و شارژ
با شماره موبایل ثبتنام کنید و کیف پول را با درگاه بانکی یا کارتبهکارت شارژ کنید.
ساخت کلید
در داشبورد یک کلید بسازید و در صورت نیاز سقف هزینه و مدلهای مجاز تعیین کنید.
تغییر آدرس پایه
در SDK خودتان base_url را روی آدرس هوشوانا بگذارید و مدل را با پیشوند سازنده بنویسید.
آدرس پایهی سازگار با OpenAI: https://hooshvana.ir/api/v1
curl https://hooshvana.ir/api/v1/chat/completions \
-H "Authorization: Bearer $HOOSHVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-5.5",
"messages": [
{"role": "user", "content": "یک شعار کوتاه برای کافهام بنویس"}
]
}'اتصال Claude Code و SDK رسمی Anthropic
Claude Code و کتابخانههای Anthropic آدرس سرور را از متغیر محیطی ANTHROPIC_BASE_URL میخوانند. کافی است این متغیر را روی آدرس هوشوانا و ANTHROPIC_AUTH_TOKEN را روی کلید هوشوانا بگذارید. نام مدلها با پیشوند anthropic نوشته میشود.
برای کنترل هزینه، روی کلیدی که به Claude Code میدهید سقف هزینهی روزانه بگذارید و مدلهای مجاز را به Sonnet و Haiku محدود کنید. راهنمای کامل با تنظیمات ویندوز و مک در صفحهی یکپارچهسازی Claude Code آمده است.
export ANTHROPIC_BASE_URL="https://hooshvana.ir/api"
export ANTHROPIC_AUTH_TOKEN="hv-..."
export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"
claudeپرسشهای پرتکرار دربارهی API Claude
Claude Code با هوشوانا کار میکند؟
بله. هوشوانا endpoint سازگار با Anthropic Messages دارد. با تنظیم ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN، Claude Code بدون تغییر به هوشوانا وصل میشود و هزینه از کیف پول ریالی شما کم میشود.
میتوانم Claude را با SDK OpenAI صدا بزنم؟
بله. در endpoint سازگار با OpenAI کافی است مقدار model را شناسهی یک مدل Claude بگذارید، مثل anthropic/claude-sonnet-4.6. هوشوانا قالب درخواست و پاسخ را برای شما تبدیل میکند.
قیمت API Claude به تومان چقدر است؟
قیمت دلاری Anthropic در نرخ دلار هوشوانا ضرب میشود. جدول همین صفحه قیمت تومانی ورودی، خروجی و ورودی کششدهی هر مدل Claude را با نرخ امروز نشان میدهد.
Prompt caching در Claude پشتیبانی میشود؟
برای مدلهایی که قیمت ورودی کششده دارند، توکنهای کششده با همان قیمت کمتر حساب میشوند. قیمت ورودی کششدهی هر مدل در صفحهی همان مدل آمده است.