اپنی ایپ میں Claude API کیسے شامل کریں
Claude API کو شامل کرنے کے لیے، Anthropic کے Claude Console میں ایک API key بنائیں، اسے سرور سائیڈ سیکرٹ کے طور پر محفوظ کریں (عموماً ANTHROPIC_API_KEY)، اور اپنے سرور کے ایک روٹ سے Anthropic کے سرکاری SDKs میں سے کسی ایک کے ذریعے Messages API کو کال کریں۔ ہر درخواست ایک model کا نام لیتی ہے، max_tokens مقرر کرتی ہے (سب سے لمبا جواب جو آپ قبول کریں گے) اور گفتگو کو messages کے طور پر بھیجتی ہے، جبکہ آپ کی ہدایات ایک الگ system پرامپٹ میں ہوتی ہیں۔ اخراجات کی حد مقرر کریں، لمبے جوابات کو اسٹریم کریں، اور rate-limit (429) اور overload (529) خرابیوں کو retries کے ساتھ سنبھالیں۔
یہ گائیڈ سیٹ اپ، ایک محفوظ درخواست کا بہاؤ، AI بلڈر کے لیے پرامپٹس، اور وہ خرابیاں بتاتی ہے جن کے لیے تیار رہنا چاہیے۔ Anthropic کی تفصیلات ستمبر 2026 تک کی ان کی دستاویزات سے لی گئی ہیں۔ عمومی طور پر ٹوکنز اور قیمتوں کا طریقہ کار جاننے کے لیے، LLM APIs کیسے استعمال کریں دیکھیں۔
آپ اس سے کیا بنا سکتے ہیں
- چیٹ اسسٹنٹس اور مدد کے ویجٹس (AI چیٹ بوٹ ایپ کیسے بنائیں)
- خلاصے، دوبارہ لکھے گئے متن اور مسودہ جوابات
- دستاویزات، ای میلز اور فارمز سے فیلڈز نکالنا
- آپ کے اپنے مواد سے سوالات کے جواب دینا
- ایجنٹس جو tool use کے ذریعے آپ کی ایپ کے فنکشنز کو کال کریں
مزید خیالات کے لیے، اپنی ایپ میں AI فیچرز کیسے شامل کریں دیکھیں۔
Messages API ایک نظر میں
Anthropic کے API ریفرنس کے مطابق، ایک درخواست https://api.anthropic.com/v1/messages پر POST ہوتی ہے، جس میں:
| حصہ | یہ کیا ہے |
|---|---|
x-api-key ہیڈر | آپ کی API key |
anthropic-version ہیڈر | API ورژن، مثلاً 2023-06-01 |
model (لازمی) | کون سا Claude model استعمال کرنا ہے |
max_tokens (لازمی) | جواب میں زیادہ سے زیادہ ٹوکنز؛ model اس سے پہلے بھی رک سکتا ہے |
messages (لازمی) | گفتگو: user اور assistant باری باری کے موڑ |
system (اختیاری) | وہ ہدایات جو پوری گفتگو پر لاگو ہوں |
stream (اختیاری) | true سیٹ کریں تاکہ جواب لکھے جانے کے ساتھ server-sent events کے ذریعے ملے |
API stateless ہے: گفتگو جاری رکھنے کے لیے، ہر درخواست کے ساتھ پچھلے موڑ دوبارہ بھیجیں۔ اسی لیے طویل چیٹس کا ہر پیغام زیادہ خرچ ہوتا ہے۔
Anthropic Python، TypeScript، C#، Go، Java، PHP اور Ruby کے لیے سرکاری SDKs شائع کرتا ہے۔ یہ ہیڈرز سیٹ کرتے ہیں، جوابات پارس کرتے ہیں، اور اسٹریمنگ کو سپورٹ کرتے ہیں۔ جب تک کوئی خاص وجہ نہ ہو، خام HTTP کے بجائے ان میں سے کوئی استعمال کریں۔
model کا انتخاب
Anthropic کئی Claude models پیش کرتا ہے جو صلاحیت، رفتار اور قیمت میں توازن رکھتے ہیں، اور ان کی فہرست بدلتی رہتی ہے۔ سب سے چھوٹا model چنیں جو آپ کا کام اچھی طرح کرے، اسے حقیقی مثالوں پر ٹیسٹ کریں، اور model ID کو کنفیگریشن میں رکھیں تاکہ کوڈ بدلے بغیر تبدیل کر سکیں۔ موجودہ آپشنز اور ریٹس کے لیے Anthropic کے models اور pricing صفحات دیکھیں۔
اپنا اکاؤنٹ سیٹ اپ کرنا
- platform.claude.com پر Claude Console میں سائن ان کریں اور بلنگ شامل کریں۔
- API key بنائیں۔ ٹیسٹنگ اور پروڈکشن کے لیے ہر ماحول کی ایک الگ key رکھیں تاکہ ایک کو منسوخ کرنے سے دوسری نہ ٹوٹے۔
- اخراجات کی حد مقرر کریں۔ Anthropic کا errors صفحہ بتاتا ہے کہ جب استعمال آپ کی مقررہ حد تک پہنچتا ہے تو API 400 خرابی لوٹاتا ہے، اس لیے آپ کی ایپ کو ایسی صورت میں واضح پیغام دکھانا چاہیے۔
- rate limits دیکھیں جو آپ کے اکاؤنٹ کے لیے Console میں ہیں؛ یہ فی تنظیم (organization) ناپی جاتی ہیں۔
درخواست کا بہاؤ
- صارف آپ کی ایپ میں کام کرتا ہے: پیغام بھیجتا ہے، یا “خلاصہ کریں” پر کلک کرتا ہے۔
- براؤزر آپ کے سرور روٹ کو کال کرتا ہے، Anthropic کو براہِ راست کبھی نہیں۔
- آپ کا سرور چیک کرتا ہے کہ صارف لاگ ان ہے اور اس فیچر کے استعمال کی اجازت رکھتا ہے، اور فی صارف حد لگاتا ہے۔
- یہ درخواست بناتا ہے: آپ کے قواعد پر مبنی system پرامپٹ، صارف کا ان پٹ، اور کام کے لیے درکار کوئی بھی ڈیٹا آپ کے ڈیٹا بیس سے۔
- یہ ماحول سے key کے ساتھ اور ایک مناسب
max_tokensکے ساتھ Messages API کو کال کرتا ہے۔ - یہ جواب براؤزر کو اسٹریم کرتا ہے اور جواب سے ٹوکن استعمال لاگ کرتا ہے۔
اختیارات اور تجارتی توازن
| فیصلہ | سادہ انتخاب | کب آگے جانا ہے |
|---|---|---|
| اسٹریمنگ | پورے جواب کا انتظار کریں | چیٹ اور ہر لمبے کام کے لیے اسٹریم کریں؛ Anthropic لمبے وقت کی درخواستوں کے لیے اسٹریمنگ یا batches تجویز کرتا ہے |
| آؤٹ پٹ فارمیٹ | سادہ متن | جب آپ کے کوڈ کو فیلڈز پڑھنے ہوں تو structured JSON آؤٹ پٹ |
| آپ کا ڈیٹا | متعلقہ ریکارڈ شامل کریں | جب بہت زیادہ ہو تو اپنے مواد پر retrieval (RAG کیا ہے) |
| عمل | model صرف متن لکھتا ہے | Tool use، جہاں model آپ کے کوڈ سے وہ فنکشن چلانے کو کہتا ہے جو آپ نے متعین کیا ہو |
| بڑے، غیر فوری کام | آئٹمز پر لوپ | Message Batches API، جسے آپ جمع کراتے ہیں اور نتائج کے لیے پولنگ کرتے ہیں |
آپ کے AI بلڈر کے لیے پرامپٹس
پہلا فیچر:
ایک “اس دستاویز کے بارے میں پوچھیں” پینل شامل کریں۔ یہ سرور روٹ POST /api/ask کو کال کرتا ہے جو چیک کرتا ہے کہ صارف لاگ ان ہے اور دستاویز کا مالک ہے، پھر آفیشل Anthropic SDK اور سیکرٹ ANTHROPIC_API_KEY کے ساتھ Claude Messages API کو کال کرتا ہے۔ model ID سیکرٹ CLAUDE_MODEL سے پڑھیں۔ System پرامپٹ: “صرف فراہم کردہ دستاویز سے جواب دیں۔ اگر جواب اس میں نہ ہو تو یہ کہیں۔” دستاویز کا متن اور سوال بھیجیں، max_tokens کو 800 مقرر کریں، جواب صفحے پر اسٹریم کریں، اور key کو کبھی براؤزر تک نہ پہنچنے دیں۔
حفاظتی انتظامات اور خرابیاں:
ہر صارف کو فی گھنٹہ 20 سوالات تک محدود کریں، جو ڈیٹا بیس میں ٹریک ہوں۔ ہر جواب سے ان پٹ اور آؤٹ پٹ ٹوکنز کو صارف ID اور request ID کے ساتھ لاگ کریں۔ 429 یا 529 خرابیوں پر exponential backoff کے ساتھ زیادہ سے زیادہ 3 بار دوبارہ کوشش کریں، retry-after ہیڈر کا احترام کرتے ہوئے، پھر “اسسٹنٹ مصروف ہے، تھوڑی دیر بعد دوبارہ کوشش کریں” دکھائیں۔ اگر API اخراجات کی حد کی خرابی بتائے تو “AI فیچرز عارضی طور پر بند ہیں” دکھائیں اور ایڈمن کو الرٹ کریں۔
جن خرابیوں کے لیے تیار رہنا ہے
Anthropic کی errors دستاویزات کے مطابق، وہ خرابیاں جن کا آپ کی ایپ کو واقعی سامنا ہوگا:
| کوڈ | قسم | کیا کرنا ہے |
|---|---|---|
| 400 | invalid_request_error | درخواست درست کریں؛ آپ کی مقرر کردہ اخراجات کی حد پر پہنچنے پر بھی یہی آتا ہے |
| 401 | authentication_error | یقینی بنائیں کہ key موجود، درست اور غیر منسوخ ہے |
| 413 | request_too_large | کم بھیجیں؛ Messages API فی درخواست 32 MB تک قبول کرتا ہے |
| 429 | rate_limit_error | backoff کریں اور retry-after کا احترام کرتے ہوئے دوبارہ کوشش کریں |
| 500 | api_error | backoff کے ساتھ دوبارہ کوشش کریں؛ اگر برقرار رہے تو request ID کے ساتھ سپورٹ سے رابطہ کریں |
| 529 | overloaded_error | تمام صارفین پر عارضی زیادہ ٹریفک؛ backoff کریں اور دوبارہ کوشش کریں |
Anthropic کی دستاویزات کہتی ہیں کہ سرکاری SDKs عارضی ناکامیوں (کنکشن کی خرابیاں، rate limits اور 5xx خرابیاں) پر ڈیفالٹ طور پر دو بار خودکار طور پر دوبارہ کوشش کرتے ہیں، اور آپ اسے کنفیگر کر سکتے ہیں۔ ہر جواب میں request-id ہیڈر ہوتا ہے؛ اسے لاگ کریں تاکہ سپورٹ مسائل کا سراغ لگا سکے۔
عام غلطیاں
- براؤزر سے API کو کال کرنا۔ آپ کی key عوامی ہو جاتی ہے۔ ہمیشہ اپنے سرور کے ذریعے جائیں۔ دیکھیں API keys کو محفوظ کیسے رکھیں۔
- یہ بھول جانا کہ
max_tokensایک حد ہے، ہدف نہیں۔ اسے فیچر کی ضرورت کے مطابق رکھیں؛ بہت کم جوابات کاٹ دیتا ہے، بہت زیادہ لمبے اور مہنگے جوابات کا خطرہ ہے۔ - ہدایات کو صارف کے پیغام میں ڈالنا۔ مستقل ہدایات
systemپرامپٹ میں جاتی ہیں؛ اجازتیں آپ کے کوڈ میں ہوتی ہیں۔ - پوری چیٹ ہمیشہ بھیجتے رہنا۔ گفتگو بڑھنے کے ساتھ پرانے موڑ کم کریں یا ان کا خلاصہ بنائیں۔
- اخراجات کی حد یا فی صارف حد نہ ہونا۔
- model ID کو سخت کوڈ میں لکھنا۔ Models اپ ڈیٹ اور ریٹائر ہوتے رہتے ہیں۔
- stop reason کو نظرانداز کرنا۔ اگر جواب
max_tokensتک پہنچ کر رکا ہو تو صارف کو بتائیں یا حد بڑھائیں۔
چیک لسٹ
- Claude Console میں API key بنائی گئی اور سرور سائیڈ سیکرٹ کے طور پر محفوظ کی گئی
- ٹیسٹنگ اور پروڈکشن کے لیے الگ keys
- اخراجات کی حد مقرر؛ پہنچنے پر واضح پیغام
- تمام درخواستیں آپ کے سرور سے، اجازت کی جانچ کے ساتھ
- System پرامپٹ میں قواعد؛ model ID کنفیگرable
- ہر فیچر کے لیے
max_tokensمقرر؛ لمبے جوابات اسٹریم ہوتے ہیں - آپ کی ایپ میں فی صارف rate limit
- 429 اور 529 backoff کے ساتھ سنبھالے گئے؛ request IDs لاگ ہوتے ہیں
- دوستانہ خرابی کی حالت جو صفحے کو نہیں توڑتی
- خالی، بہت لمبے اور نامناسب ان پٹس کے ساتھ ٹیسٹ کیا گیا
Mythex میں Claude API استعمال کرنا
Mythex پر بنائی گئی ایپس میں Claude کے فیچرز آپ کی اپنی Anthropic key استعمال کرتے ہیں اور بلنگ آپ کے Anthropic اکاؤنٹ میں ہوتی ہے، Mythex بلڈ کریڈٹس میں نہیں۔ یہ اس Mythex ایجنٹ سے الگ ہے جو آپ کا کوڈ لکھتا ہے۔ ANTHROPIC_API_KEY کو /secrets، پروجیکٹ سیٹنگز یا چیٹ میں سیکرٹس کارڈ کے ذریعے پروجیکٹ سیکرٹ کے طور پر شامل کریں، پھر اوپر جیسے پرامپٹس استعمال کرتے ہوئے فیچر بیان کریں۔ سیکرٹس بدلنے کے بعد لائیو ایپ کو دوبارہ پبلش کریں۔ شروعاتی پرامپٹ کے لیے AI فیچرز اپنی API keys کے ساتھ شامل کریں دیکھیں۔ اگر آپ فراہم کنندگان کے درمیان انتخاب کر رہے ہیں تو OpenAI API کو کیسے شامل کریں وہی بات OpenAI کے لیے بیان کرتا ہے۔
سوالات
Claude API key کیسے حاصل کروں؟
platform.claude.com پر Claude Console میں سائن ان کریں، بلنگ سیٹ اپ کریں، اور API key بنائیں۔ اسے سرور سائیڈ سیکرٹ کے طور پر محفوظ کریں، جس کا عام نام ANTHROPIC_API_KEY ہوتا ہے، اور اسے کبھی براؤزر کوڈ میں نہ ڈالیں۔
Claude API کی درخواست کے لیے کیا چاہیے؟
Anthropic کے Messages API ریفرنس کے مطابق، ستمبر 2026 تک، باڈی میں تین لازمی فیلڈز ہیں: model، max_tokens اور messages۔ براہِ راست HTTP کالز کو x-api-key اور anthropic-version ہیڈرز بھی چاہییں؛ سرکاری SDKs یہ ہیڈرز خود سیٹ کر دیتے ہیں۔
Claude API کی طرف سے 529 خرابی کیا ہے؟
Anthropic کے errors صفحے کے مطابق 529 کا مطلب overloaded_error ہے: تمام صارفین کے زیادہ ٹریفک کی وجہ سے API عارضی طور پر اوورلوڈ ہے۔ exponential backoff کے ساتھ دوبارہ کوشش کریں۔ سرکاری SDKs کچھ عارضی خرابیوں پر خود بخود دوبارہ کوشش کرتے ہیں۔
کیا OpenAI SDK کے لیے لکھے گئے کوڈ کے ساتھ Claude استعمال کیا جا سکتا ہے؟
Anthropic ایک OpenAI SDK مطابقت کی پرت (compatibility layer) کی دستاویز فراہم کرتا ہے جس سے OpenAI SDK کے ذریعے Claude استعمال ہو سکتا ہے۔ نئے کوڈ کے لیے، اس کے اپنے SDKs Claude کی مخصوص خصوصیات تک رسائی دیتے ہیں، اس لیے عموماً وہی بہتر نقطۂ آغاز ہیں۔