API یک رابط فنی به مدل است، نه تضمین کیفیت محصول. تفاوت نسخهٔ آزمایشی و سرویس قابل اتکا در validation، timeout، retry سنجیده، هزینه، log امن، test set و fallback انسانی است.
کلید واقعی را در تمرین، screenshot یا repository قرار ندهید. قابلیت، مدل‌های موجود، قیمت و محدودیت نرخ را فقط از مستندات رسمی روز Anthropic بررسی کنید؛ دوره مستقل است و تأیید رسمی ادعا نمی‌کند.
معیارهایی که باید مدرک داشته باشند
پیش‌نیاز فنی
ساخت request، خواندن response و مدیریت env باید قبل از مدل روشن باشد.
مدرک قابل مشاهده: تمرین کوچک بدون AI.قرارداد ورودی/خروجی
schema و validation جلوی ورود و خروج نامعتبر را بگیرند.
مدرک قابل مشاهده: test برای field گمشده.مدیریت خطا
timeout، rate limit و خطای سرویس با retry محدود یا fallback کنترل شوند.
مدرک قابل مشاهده: failure matrix.ارزیابی
تغییر prompt یا مدل از test set عبور کند.
مدرک قابل مشاهده: eval run و regression.امنیت و هزینه
کلید، log، داده و سقف مصرف کنترل شوند.
مدرک قابل مشاهده: secret policy و budget guard.نردبان پیش‌نیاز تا prototype
هر پله artifact دارد؛ اگر پلهٔ اول سخت است، ابتدا مسیر پایهٔ توسعه را تکمیل کنید.
| پله | دانش | artifact | قبولی |
|---|---|---|---|
| ۱ | HTTP/JSON/env | کلاینت mock | خطاها مدیریت |
| ۲ | API پایه | یک request محدود | کلید خارج از کد |
| ۳ | قرارداد | schema validator | ورودی بد رد |
| ۴ | قابلیت اتکا | timeout/retry/log | failure tests |
| ۵ | ارزیابی | test set | regression پاس |
روش اجرای این راهنما
- با mock شروع کنیدپیش از هزینه و secret، flow را با پاسخ ثابت بسازید.
- یک endpoint محدود بسازیدیک ورودی و یک خروجی، بدون agent و ابزار اضافی.
- failure را عمداً ایجاد کنیدtimeout، 429، JSON بد و پاسخ خالی.
- هزینه را اندازه بگیریدتخمین را با usage واقعی پایلوت جایگزین کنید.
خطاهایی که تصمیم را خراب می‌کنند
- قرار دادن کلید در کدافشای secret یک خطای جدی است.
- retry نامحدودهزینه و فشار سرویس را افزایش می‌دهد.
- دمو مساوی productionprototype بدون observability و eval آماده نیست.
منابع رسمی و اولیه
صفحهٔ دوره Claude API را با نردبان بسنجید
پیش‌نیاز و خروجی را مرور کنید؛ برای قیمت و قابلیت API به مستندات رسمی Anthropic رجوع کنید.
بررسی دورهٔ Claude API