رفتن به محتوای اصلی
هوشوانا

API Claude در ایران، سازگار با Anthropic و OpenAI

Claude خانواده‌ی مدل‌های زبانی Anthropic است که در کدنویسی، نوشتن متن طولانی و پیروی از دستورهای دقیق شناخته می‌شود. نسخه‌های Haiku سریع و اقتصادی‌اند، Sonnet توازن کیفیت و هزینه دارد و Opus برای سخت‌ترین کارهاست.

هوشوانا هم endpoint سازگار با Anthropic Messages دارد و هم سازگار با OpenAI. پس Claude Code و SDK رسمی Anthropic بدون تغییر کد وصل می‌شوند و اگر کدتان با SDK OpenAI نوشته شده، همان را با شناسه‌ی مدل Claude صدا می‌زنید.

قیمت API 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
مدلیک پیام کوتاه چت‌باتیک مقاله‌ی ۱۵۰۰ کلمه‌ای فارسیخلاصه‌ی یک سند ۲۰ صفحه‌ای
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 در سه قدم

  1. ثبت‌نام و شارژ

    با شماره موبایل ثبت‌نام کنید و کیف پول را با درگاه بانکی یا کارت‌به‌کارت شارژ کنید.

  2. ساخت کلید

    در داشبورد یک کلید بسازید و در صورت نیاز سقف هزینه و مدل‌های مجاز تعیین کنید.

  3. تغییر آدرس پایه

    در SDK خودتان base_url را روی آدرس هوشوانا بگذارید و مدل را با پیشوند سازنده بنویسید.

آدرس پایه‌ی سازگار با OpenAI: https://hooshvana.ir/api/v1

cURL
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 آمده است.

Shell
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 پشتیبانی می‌شود؟

برای مدل‌هایی که قیمت ورودی کش‌شده دارند، توکن‌های کش‌شده با همان قیمت کمتر حساب می‌شوند. قیمت ورودی کش‌شده‌ی هر مدل در صفحه‌ی همان مدل آمده است.

اولین درخواست API Claude را همین امروز بفرستید