API Claude (کلاد) در ایران: خرید، قیمت تومانی و راهنمای اتصال

Claude (یا به قول خیلی‌ها «کلود») برای خیلی از برنامه‌نویس‌ها مدلی است که کد تمیز می‌نویسد، دستورهای بلند را دقیق دنبال می‌کند و فارسی را طبیعی می‌نویسد. ولی قیمتش هم از بیشتر رقبا بالاتر است، و همین باعث می‌شود «کدام Claude» و «چقدر خرج دارد» سؤال اصلی باشد، نه فقط «چطور وصل شوم». این مقاله روی خود خانوادهٔ Claude تمرکز دارد: قیمت تومانی هر نسخه، اینکه برای کار تو Haiku کافی است یا Sonnet و Opus لازم است، و دو ابزاری که بیشترین اثر را روی صورت‌حساب Claude دارند: کش پرامپت و بودجهٔ استدلال. کد آمادهٔ Python و curl هم داری.

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

چرا خرید مستقیم API Claude از ایران سخت است

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

راه کوتاه‌تر: با موبایل ایرانی ثبت‌نام می‌کنی، کیف پول را از درگاه زیبال به تومان شارژ می‌کنی (کمترین مبلغ ۱۰۰٬۰۰۰ تومان)، یک کلید sk-up- می‌سازی و با SDK رسمی OpenAI به همهٔ مدل‌های Claude وصل می‌شوی. آدرس api.uttapen.ir داخل ایران است و VPN لازم نیست؛ مسیر بین‌المللی درخواست را زیرساخت ما در خارج از ایران مدیریت می‌کند.

قیمت API Claude (کلاد) به تومان

ستون آخر هزینهٔ یک درخواست معمولی فارسی است: حدود ۱٬۰۰۰ کلمه ورودی (تقریباً ۱٬۷۸۰ توکن) و ۵۰۰ کلمه پاسخ (حدود ۸۹۰ توکن). همین مبنا را در مقالهٔ قیمت API مدل‌ها به تومان، راهنمای API دیپ سیک و راهنمای API جمینای هم به کار برده‌ایم، پس اعداد قابل مقایسه‌اند. قیمت‌ها به‌ازای هر یک میلیون توکن و به تومان است و هنگام ساخته‌شدن صفحه از کاتالوگ زنده خوانده می‌شوند؛ با تغییر نرخ دلار یا قیمت سازنده، این‌ها هم عوض می‌شوند.

فهرست کامل همهٔ نسخه‌های Claude با قیمت زنده در صفحهٔ مدل‌های Anthropic است. چند نکته از همین جدول:

• جدیدتر اینجا ارزان‌تر است. Sonnet 5.5، تازه‌ترین Sonnet، همان قیمت Sonnet 5 را دارد. هر دو برای همان درخواست حدود یک‌سوم ارزان‌تر از Sonnet 4.5 و 4.6 تمام می‌شوند، و Opus 5.5 حدود ۲۰٪ ارزان‌تر از Opus 5 و Opus 4.8. اگر کدت هنوز روی نسخهٔ قدیمی است، عوض کردن یک رشته ممکن است صورت‌حسابت را پایین بیاورد؛ فقط قبلش خروجی را روی نمونهٔ واقعی خودت مقایسه کن.
• Opus 4.1 گران‌ترین ردیف است. هر درخواستش حدود ۱۵ برابر Haiku 4.5 و نزدیک ۴ برابر Opus 5.5 خرج دارد و context کوچک‌تری هم دارد. برای پروژهٔ تازه دلیلی برای شروع با آن نمی‌بینیم.
• با شارژ حداقلی: ۱۰۰٬۰۰۰ تومان یعنی حدود ۴۶ درخواست هزارکلمه‌ای با Haiku 4.5، حدود ۲۳ درخواست با Sonnet 5 و حدود ۱۱ درخواست با Opus 5.5. Claude برای تست کوتاه مناسب است، ولی برای حجم بالا باید حساب‌شده انتخابش کنی.
• هیچ مدل Claude رایگان نیست. اگر فقط می‌خواهی کار با API را بدون پرداخت یاد بگیری، سراغ مدل‌های رایگان کاتالوگ برو.

همهٔ مدل‌های این جدول استدلال (reasoning)، tool calling و ورودی تصویر را پشتیبانی می‌کنند.

کدام Claude را انتخاب کنم

عدد بنچمارک نمی‌آوریم؛ کیفیت را روی دادهٔ خودت بسنج. ولی بر اساس قیمت و جایگاه هر نسخه در خانواده، این نقطهٔ شروع منطقی است:

Haiku 4.5 برای کار سریع و پرحجم. دسته‌بندی تیکت، استخراج فیلد از متن، خلاصهٔ کوتاه، مسیریابی درخواست‌ها بین مدل‌ها. ارزان‌ترین Claude است و برای خیلی از کارهای تکراری کافی است.

Sonnet 5 برای کار روزمره. کدنویسی، نوشتن و ویرایش متن فارسی، چت پشتیبانی، کار با سند بلند. با context یک‌میلیون‌توکنی و قیمتی پایین‌تر از Sonnetهای قبلی، پیش‌فرض خوبی برای بیشتر پروژه‌هاست. اگر دنبال مقایسهٔ Claude با بقیه برای کد هستی، مقالهٔ بهترین مدل برای کدنویسی را هم ببین، و اگر می‌خواهی Claude را داخل ترمینال یا VS Code به کار بگیری، راهنمای Claude Code در ایران را بخوان.

Opus 5.5 یا Fable 5.1 برای سخت‌ترین کارها. تحلیل‌های چندمرحله‌ای، تغییرات بزرگ در کد، کارهایی که هزینهٔ یک اشتباه در آن‌ها از هزینهٔ توکن بیشتر است. منطقی است فقط درخواست‌هایی را به این‌ها بفرستی که مدل ارزان‌تر از پسشان برنیامده. Fable 5.1 گران‌ترین مدل جدید این فهرست است و حدود دو و نیم برابر Opus 5.5 خرج دارد؛ اول Opus 5.5 را امتحان کن.

اتصال به API Claude با Python

همان SDK رسمی OpenAI کافی است؛ فقط base_url و کلید عوض می‌شود و شناسهٔ مدل با پیشوند anthropic/ نوشته می‌شود. لازم نیست SDK جداگانهٔ Anthropic نصب کنی.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uttapen.ir/v1",
    api_key=os.environ["UTTAPEN_API_KEY"],  # کلید sk-up-... از داشبورد
)

raw = client.chat.completions.with_raw_response.create(
    model="anthropic/claude-sonnet-5",
    messages=[
        {"role": "system", "content": "به فارسی، کوتاه و دقیق جواب بده."},
        {"role": "user", "content": "این تابع Python را طوری بازنویسی کن که فایل را خط به خط بخواند:\n\ndef load(p):\n    return open(p).read().split('\\n')"},
    ],
    max_tokens=800,
)
resp = raw.parse()
print(resp.choices[0].message.content)
print("هزینه:", raw.headers.get("X-Uttapen-Cost-Toman"), "تومان")
print("موجودی:", raw.headers.get("X-Uttapen-Balance-Toman"), "تومان")

X-Uttapen-Cost-Toman هزینهٔ دقیق همین درخواست است و X-Uttapen-Balance-Toman موجودی بعد از آن. قدم‌به‌قدم ثبت‌نام، شارژ و ساخت کلید در شروع سریع آمده.

همان درخواست با curl

curl https://api.uttapen.ir/v1/chat/completions \
  -H "Authorization: Bearer $UTTAPEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-haiku-4.5",
    "messages": [
      {"role": "user", "content": "این پیام مشتری را در یکی از دسته‌های «ارسال»، «پرداخت» یا «مرجوعی» بگذار: سفارشم سه روز است نرسیده."}
    ],
    "max_tokens": 50
  }'

پاسخ قالب OpenAI است: choices[0].message.content، finish_reason و بلوک usage. برای استریم، "stream": true اضافه کن. تصویر و PDF هم با همان بخش‌های image_url و file در content فرستاده می‌شوند؛ جزئیاتش در مستندات ورودی تصویر و فایل است.

استدلال در Claude: بودجه را خودت تعیین کن

مدل‌های Claude می‌توانند قبل از جواب «فکر کنند». بلوک reasoning را در بدنه بفرست؛ برای Anthropic علاوه بر effort می‌توانی با max_tokens داخل همین بلوک سقف مستقیم توکن‌های استدلال را بگذاری، که برای کنترل هزینه دقیق‌تر است:

schema_sql = open("schema.sql", encoding="utf-8").read()

resp = client.chat.completions.create(
    model="anthropic/claude-opus-5.5",
    messages=[{"role": "user", "content": "این طراحی جدول سفارش‌ها برای گزارش ماهانه چه مشکلی دارد؟\n\n" + schema_sql}],
    max_tokens=8000,
    extra_body={"reasoning": {"max_tokens": 4000}},  # یا {"effort": "medium"}
)
msg = resp.choices[0].message
thinking = getattr(msg, "reasoning", None) or (msg.model_extra or {}).get("reasoning")
if thinking:
    print("[استدلال]", thinking[:300], "…")
print(msg.content)

توکن‌های استدلال با قیمت خروجی شارژ می‌شوند، و خروجی Claude گران است؛ روی Opus 5.5 هر هزار توکن استدلال حدود ۶٬۹۰۰ تومان است. پس:

1. max_tokens کل را از بودجهٔ استدلال بزرگ‌تر بگذار. این سقف هم استدلال و هم پاسخ را می‌پوشاند؛ اگر کوچک باشد، مدل وسط فکر کردن قطع می‌شود و content خالی برمی‌گردد در حالی که هزینهٔ استدلال پرداخت شده.
2. رزرو سه برابر می‌شود. وقتی درخواست reasoning دارد، برآورد خروجی برای رزرو قبل از ارسال سه برابر حساب می‌شود. بعد از پاسخ فقط مصرف واقعی کم می‌شود.
3. برای کار ساده استدلال را روشن نکن. اول بدون آن تست کن؛ فقط اگر کیفیت نرسید اضافه‌اش کن.

همهٔ گزینه‌ها و خواندن استدلال در استریم در مستندات مدل‌های استدلالی است.

کش پرامپت: بزرگ‌ترین صرفه‌جویی در Claude

اگر ابتدای درخواست‌هایت ثابت است (پیام system بلند، دستورالعمل محصول، یک سند مرجع، چند نمونهٔ ثابت)، کش پرامپت بیشترین اثر را روی هزینه دارد. در Claude کش به‌طور پیش‌فرض روشن نیست؛ باید با cache_control مشخص کنی تا کجای پرامپت کش شود. برای این کار content را به‌جای رشته، آرایه‌ای از بخش‌ها می‌فرستی و روی بخشی که تا انتهایش ثابت است cache_control می‌گذاری:

policy = open("support_policy.md", encoding="utf-8").read()  # چند هزار توکن متن ثابت

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[
        {
            "role": "system",
            "content": [
                {"type": "text", "text": "تو پشتیبان فروشگاه هستی. فقط بر اساس این سیاست‌ها جواب بده:\n\n" + policy,
                 "cache_control": {"type": "ephemeral"}},
            ],
        },
        {"role": "user", "content": "می‌توانم کفشی را که پوشیده‌ام پس بدهم؟"},
    ],
    max_tokens=500,
)
details = resp.usage.prompt_tokens_details
print("توکن خوانده‌شده از کش:", details.cached_tokens if details else 0)

دروازهٔ ما آرایهٔ messages را همان‌طور که فرستاده‌ای و بدون تغییر عبور می‌دهد، پس cache_control به مدل می‌رسد. شارژ هم از روی مصرفی است که برای همان درخواست گزارش می‌شود، یعنی بخش کش‌شده با قیمت ستون «خواندن از کش» حساب می‌شود. تعداد توکن‌های خوانده‌شده از کش در usage.prompt_tokens_details.cached_tokens می‌آید.

ببین تفاوت چقدر است: روی Sonnet 5 ورودی عادی ۶۹۲٬۴۳۹ تومان به‌ازای هر میلیون توکن است و خواندن از کش ۶۹٬۲۴۴، یعنی یک‌دهم. روی Opus 5.5 نسبت یک‌بیستم است و روی Fable 5.1 حدود یک‌چهلم. در عوض، اولین بار که بخشی در کش نوشته می‌شود، کمی گران‌تر از ورودی عادی است (ستون «نوشتن در کش»). پس کش وقتی می‌ارزد که همان پیشوند را چند بار پشت سر هم بفرستی؛ عمر کش کوتاه است (چند دقیقه) و بخش‌های خیلی کوتاه اصلاً کش نمی‌شوند. بخش ثابت را همیشه اول بگذار و متن متغیر را بعد از آن.

کنترل هزینهٔ Claude

• همیشه max_tokens بفرست. اگر نفرستی، رزرو قبل از ارسال با سقف پیش‌فرض ۳۲٬۷۶۸ توکن خروجی حساب می‌شود؛ روی Sonnet 5 فقط بخش خروجی این رزرو حدود ۱۱۰٬۰۰۰ تومان برای یک درخواست است. اگر موجودی به آن نرسد، درخواست رد نمی‌شود و سقف خروجی تا جایی که موجودی می‌کشد پایین می‌آید (عددش در هدر X-Uttapen-Max-Tokens می‌آید)، ولی ممکن است پاسخ با finish_reason: "length" کوتاه تمام شود. عدد واقعی بگذار تا نه رزرو بی‌دلیل بزرگ شود نه پاسخ نیمه‌کاره بماند.
• مدل را پله‌ای بالا ببر. اول Haiku، اگر کیفیت نرسید Sonnet 5، و فقط در آخر Opus.
• برای هر پروژه کلید جدا بساز. هر کلید می‌تواند سقف ماهانهٔ تومانی و فهرست مدل‌های مجاز داشته باشد؛ مثلاً کلید ربات پشتیبانی را فقط به anthropic/claude-haiku-4.5 محدود کن.
• خطا هزینه ندارد. درخواستی که با خطا تمام شود هیچ مبلغی کم نمی‌کند، و اگر استریم را وسط کار قطع کنی فقط بابت توکن‌های تولیدشده پول می‌دهی. جزئیات در صفحهٔ قیمت‌ها آمده.

سؤال‌های پرتکرار

کدی که با SDK رسمی Anthropic نوشته‌ام اینجا کار می‌کند؟

دروازه قالب OpenAI را می‌فهمد، پس باید تماس‌ها را به SDK رسمی OpenAI (یا هر کتابخانهٔ سازگار با آن) منتقل کنی. تغییرها معمولاً کوچک است: client.messages.create می‌شود client.chat.completions.create، پیام system به‌جای پارامتر جدا داخل messages می‌آید، و نام مدل با پیشوند می‌شود (anthropic/claude-sonnet-5).

قیمت API کلاد ثابت است؟

نه. قیمت تومانی با نرخ دلار و قیمت سازنده عوض می‌شود (جدول بالا هم همین قیمت روز را نشان می‌دهد)، ولی هر درخواست با قیمتی تسویه می‌شود که لحظهٔ ارسالش معتبر بوده. قیمت زنده را در صفحهٔ هر مدل یا با GET /v1/models (بدون نیاز به کلید) بگیر.

Claude فارسی را خوب می‌فهمد؟

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

کمترین مبلغ برای شروع کار با API Claude چقدر است؟

کمترین شارژ ۱۰۰٬۰۰۰ تومان است که امروز برای حدود ۴۶ درخواست هزارکلمه‌ای با Haiku یا ۲۳ درخواست با Sonnet 5 کافی است؛ برای تست با درخواست‌های کوتاه‌تر، خیلی بیشتر. اشتراک ماهانه یا بستهٔ از پیش تعیین‌شده در کار نیست و فقط بابت مصرف واقعی پول می‌دهی.

جمع‌بندی

برای بیشتر پروژه‌ها با anthropic/claude-sonnet-5 شروع کن، کارهای تکراری را به anthropic/claude-haiku-4.5 بسپار و فقط سخت‌ترین درخواست‌ها را به anthropic/claude-opus-5.5 بفرست. اگر پرامپت ثابت و بلندی داری، cache_control را همین امروز اضافه کن؛ در Claude معمولاً هیچ تغییر دیگری به این اندازه هزینه را پایین نمی‌آورد. برای شروع، یک حساب بساز، ۱۰۰ هزار تومان شارژ کن و نمونهٔ Python بالا را اجرا کن؛ هدر X-Uttapen-Cost-Toman همان لحظه می‌گوید درخواستت چند تومان تمام شد.