ڈپ سیک API کا انٹگریشن گائیڈ: آئی او این کیمپٹیبل ریکوارڈز کے ذریعے ای سی اے ایکس سے

یہ گائیڈ آپ کو ای سی اے ایکس کے ذریعے ڈپ سیک کی ایک مودل آئی ڈی کو ٹیسٹ کرنے کا طریقہ بتاتی ہے، جبکہ آئی او این کیمپٹیبل ایپینڈ پوائنٹس کا استعمال کرتے ہوئے۔

یہ گائیڈ سب سے چھوٹے کام کرنے والے ریکوارڈ، پیٹھون اور کیرل کے مثالوں، مودل آئی ڈی کی تائید، سٹریمینگ، ساختہ آؤٹ پٹ، ٹولز، اور عام خطاوں کے لیے ڈیگنوسٹک پاتھ کا بیان کرتا ہے۔

یہ گائیڈ ای سی اے ایکس گیتے وے کو ایک مودل آئی ڈی کے لیے اکاؤنٹس میں موجود موجودہ ای سی اے ایکس کیٹالگ میں پیش کیا جاتا ہے۔ یہ ادارہ ای سی اے ایکس کو ڈپ سیک کا رسمی ایپینڈ پوائنٹ کہنا نہیں کرتا ہے اور ہر گیتے وے کے روت کے ذریعے ہر ڈپ سیک فیچر کو دستیاب نہیں ہوتا ہے۔ لیکسٹ مودل پیج اور پروفائٹر کی ڈاکیمنٹیشن چیک کر لیں جب آپ کو پروڈکشن میں کام کرنے کی ضرورت ہو۔

سریع شروع

اگر آپ کو آئی او این سڈ کی ایک ایپلی کیشن موجود ہے تو اس سلسلے کا استعمال کریں:

1. ڈپ سیک 4.1 فلش مودل پیج کو کھولیں اور یہ تائید کریں کہ آئی ڈی دستیاب ہے۔
2. ای سی اے ایکس ایپینڈ کی کیس بنائیں۔
3. آئی او این کیمپٹیبل بیس یو آر ایل کو اسٹیل کرنے کے لیے https://ecaix.com/api/ai/v1 رکھیں۔
4. جہاں ممکن ہو اس کے علاوہ سڈ اور ایپلی کیشن کو تبدیل نہ کریں۔
5. نیچے دیے گئے سب سے چھوٹے ریکوارڈ کو چلائیں۔
6. سٹریمینگ، جین ایم پی، یا ٹولز کو صرف جب بنیادی ریکوارڈ کام کرے تو اضاف کریں۔

انڈپوائنٹ اور مودل آئی ڈی

آئی او این کیمپٹیبل کلینٹز کے لیے استعمال کریں:

بیس یو آر ایل: https://ecaix.com/api/ai/v1
مودل:    deepseek-v4.1-flash

مودل آئی ڈی ایک بلاگ پوسٹ میں دائمی گارنٹی نہیں ہے۔ ہر نیا انٹگریشن یا ڈپلوئمنٹ سے پہلے لیکسٹ مودل ڈائریکٹری (/models) میں تائید کریں۔ اگر آپ کو ایک مختلف ڈپ سیک فیملی کے لیے مودل آئی ڈی کی ضرورت ہے تو مودل کی تفصیلی پیج سے درست آئی ڈی کا استعمال کریں، نہ کہ سوئفٹ کا گیسٹنگ کریں۔

انڈپوائنٹ فارمٹ بھی اہم ہے۔ سڈ کو بیس پتھ کے ساتھ /v1 تک پہنچنے کو ضروری ہے، جبکہ کلینٹ کو /chat/completions یا دوسرا آپریشن پتھ اضاف کرنا ہوگا۔ سڈ کو بیس یو آر ایل پر /chat/completions کو اضاف نہ کریں جبکہ سڈ اس کو خود ہی اضاف کرے۔

پیٹھون میں آئی او این سڈ کے ساتھ

ویرچوال انویرنمنٹ میں پیٹھون سڈ کو اپگریڈ کریں:

python -m pip install --upgrade openai

اس کے بعد ای سی اے ایکس بیس یو آر ایل اور ایپینڈ کی کیس کا استعمال کریں:

const client = new OpenAI({
  apiKey: process.env.ECAIX_API_KEY,
  baseURL: "https://ecaix.com/api/ai/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [
    { role: "user", content: "آئی پینڈ ٹیسٹنگ کے بارے میں ایک چھوٹا سنتز واپس کریں۔" },
  ],
  max_tokens: 128,
});

console.log(response.choices[0].message.content);

ایپینڈ ریکوارڈ کے لیے سرویسر سائیڈ کی کڈ استعمال کریں۔ ایک براؤزر ایپلی کیشن کو ای سی اے ایکس کی کیس کو کلینٹ سائیڈ جیسٹ پٹھ میں رکھنے کی بجائے اپنے بکینڈ کو کال کریں۔

کیرل ڈیگنوسٹک ریکوارڈ

اگر سڈ ناکام ہو گیا تو سڈ کو ان کے ساتھ ناکام کر کے انڈپوائنٹ کو ڈائریکٹ میں ٹیسٹ کریں۔ ہیڈرز اور بڈی کو الگ الگ بچائیں تاکہ آپ کو ایچ ٹی ٹی پرمشن سے رپرسن فارمٹ پرمشن کا فرق معلوم ہو۔

curl -sS -D /tmp/ecaix-deepseek-headers.txt \
  -o /tmp/ecaix-deepseek-response.json \
  -w '\nHTTP %{http_code}\n' \
  "https://ecaix.com/api/ai/v1/chat/completions" \
  -H "Authorization: Bearer ${ECAIX_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "یک چھوٹا سنتز میں رپرس کریں۔"}
    ],
    "max_tokens": 128
  }'

پبلک ٹکٹ میں بچائے گئے ہیڈرز یا رپرس کو نہ پست کریں، نہ کہ کیس آئی ڈی، پرومپ، ریپوزٹری پتھ، یا کستمر ڈیٹا کو شامل نہ کریں۔

رپرس کا ڈیگنوسٹک

اس ترتیب کا استعمال کریں:

1. ایچ ٹی ٹی اسٹیس: دیکھیں کہ ریکوارڈ ایک معتبر انڈپوائنٹ تک پہنچ گیا ہے۔
2. رپرس بڈی: پروفائٹر یا گیتے وے کی خطا کو پڑھیں۔
3. مودل آئی ڈی: موجودہ مودل ڈائریکٹری سے درست آئی ڈی کا استعمال کریں۔
4. اُٹھنٹیکیشن: ہیڈر کی کیس، اکاؤنٹ، اور پرفارمنس چیک کریں۔
5. ریکوارڈ فارمٹ: بڈی کو model, messages, اور چھوٹے آؤٹ پٹ کی لیمٹ پر کم کر دیں۔
6. فیچر فیلڈز: ایک ایک کر کے سٹریمینگ، جین ایم پی، یا ٹولز کو اضاف کریں۔
7. سڈ کی بیاہ: سڈ کے ریکوارڈ کو ڈائریکٹ کیرل ریکوارڈ سے سمجھیں۔

یہ ایک کلینٹ لائبریری کیس سے گارنٹی نہیں دیتا کہ یہ مودل روتنگ یا اکاؤنٹ پرفارمنس کیس سے منسلک ہے۔

سٹریمینگ رپرس

اگر ایپلی کیشن کو انکرنٹل آؤٹ پٹ کی ضرورت ہے تو سٹریمینگ کو صرف جب ایک ناکام ریکوارڈ کامیاب ہو جائے تو اضاف کریں:

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "آئی پینڈ ریٹارز کے بارے میں تین پوائنٹس میں سمیٹ کریں۔"}],
    stream=True,
    max_tokens=256,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

انڈپوائنٹ اور سڈ کی رفتار پر انکرنٹل ایونٹ کی رفتار کا انحصار ہے۔ آپ کی فریم ورک کو ایک خالی ڈیلٹا، آخری استعمال کی ایونٹ، کنیکشن کا انٹرپریشن، اور [DONE] سٹائل ٹرمینیشن کی رفتار چیک کر لیجیے۔ سٹریمینگ کو پروڈکشن گراڈ میں استعمال کرنے سے پہلے آپ کو ڈس کانیکٹ اور ری ٹرائیز کی ٹیسٹنگ کرنی چاہیے۔

ساختہ آؤٹ پٹ اور جین ایم پی

اگر آپ کو ماشین ریڈیبل آؤٹ پٹ کی ضرورت ہے تو پہلے ایک عادی ریکوارڈ چلائیں اور پھر انڈپوائنٹ اور مودل کے ذریعے مدد یافتہ ساختہ آؤٹ پٹ کا سب سے چھوٹا آپشن اضاف کریں۔ رپرس کو جین ایم پی کے ساتھ واپس کرنے کا ایک پرومپ نہیں ہے، بلکہ اس کی ایک سکیما فورسڈ رپرس ہے۔

import json

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[
        {
            "role": "user",
            "content": "تیز اور پریورٹی کے ساتھ ایک جین ایم پی آبجیکٹ واپس کریں۔"
        }
    ],
    response_format={"type": "json_object"},
    max_tokens=128,
)

payload = json.loads(response.choices[0].message.content)
print(payload["title"])

response_format کو قبول کیا جا سکتا ہے یا نہیں، یہ مودل اور روت پر منحصر ہو سکتا ہے۔ اگر انڈپوائنٹ ایک غیر مدد یافتہ پارامٹر کی خطا واپس کرے تو اس فیلڈ کو ہٹا کر اور روت ڈاکیمنٹیشن چیک کر پہلے دوسرا فارمٹ ٹیسٹ کریں۔

فکشن کالنگ اور ٹولز

ٹول کالنگ کو ٹیکسٹ جنیریشن سے الگ ٹیسٹ کرنا ضروری ہے۔ پہلے ایک ہارملس فکشن کا ٹیسٹ کریں اور واپس واپس ہونے والی نام اور آرگومینٹس کو چیک کریں۔ کچھ نہیں کرنے کے لیے کوئی بھی کام نہ کریں۔

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_demo_status",
            "description": "یکسے ایک ثابت اسٹیسس واپس کریں جو لکسیٹ کامپٹیبل ٹیسٹ کے لیے استعمال کیا

## OpenAI اور Anthropic کے لیے قابل ملاقات پیمائیں

**ECAIX** مختلف کارکنڈروں کے لیے مختلف قابل ملاقات سطح فراہم کرتا ہے:

| کارکنڈ یا کام | ڈاکیمنٹیشن کا پیمائنا | کیا چکنا ہوگا |
|----------------|--------------------------|----------------|
| OpenAI Python/Node SDK | `/api/ai/v1` | چٹ چیلنجز، رپونز، سٹریمنگ، ٹولز |
| Anthropic سٹائل کارکنڈ | `/api/ai/v1/anthropic` | مساجز فیلڈز، ہیڈرز، کانٹینٹ بلک |
| کلاڈ کڈ ٹرائیڈ پارٹی کام | `/api/ai/v1/anthropic` | پروفائڈر کے خاص رفتار؛ نہیں Anthropic کی رسمی حمایت |

[چٹ چیلنجز ڈاکیمنٹیشن](/docs/api/chat-completions)، [رپونز ڈاکیمنٹیشن](/docs/api/responses)، اور [Anthropic مساجز ڈاکیمنٹیشن](/docs/api/anthropic-messages) پڑھنے سے پہلے ایک پیمائنا منتخب کریں۔ ایک ہی مودل آئی ڈی مختلف قابل ملاقات سطحوں پر ایک ہی فیلڈز یا رفتار نہیں فراہم کر سکتا ہے۔

## موجودہ مودل کی تفصیلات

زیادہ تر تفصیلی صفحات کی جگہ قابلیت اور دستیاب ہونے کی چیک کرے:

- [DeepSeek v4.1 فلش](/models/deepseek/deepseek-v4.1-flash)
- [DeepSeek v4 پرو 202606](/models/deepseek/deepseek-v4-pro-202606)
- [Qwen 3.8 فلش](/models/qwen/qwen3.8-flash)
```markdown
- [GLM 5.3](/models/glm/glm-5.3)

یہ صفحات ایک سٹیکٹک آرٹیکل سے زیادہ قابل اعتماد ہیں، جو مودل آئی ڈی، کنٹیکسٹ معلومات اور پریسنگ لینکز کے لیے۔

عام خطا

سیکیورٹی اور پروڈکشن چیک لیسٹ

پروڈکشن پر جانے سے پہلے:

• ایپائی کیز سرور سائیڈ پر سٹور کر دیے جائیں اور انھیں روتے جائیں۔
• پرومپٹس اور رپونز میں غیر منظور شدہ سیکرٹ یا کस्टمر ڈیٹا نہ ہو۔
• گیتوی کی لوجز پر ریکارڈ کی جانی چاہیے اور لوجز کی ریکارڈ کی مدت سمجھ لی جانی چاہیے۔
• مودل کی دستیابیت اور پریسنگ چیک کریں۔
• ٹائم آؤٹ، ریٹری، آئیڈمپٹنسی اور ریت لیمٹس اپلیکیشن کے ذریعے ہانڈل کریں۔
• سٹریمنگ ڈس کانکشن ڈوپلیکٹ جابز نہیں بنائے۔
• ٹول کولز پر ایلیسٹ، والڈیشن، ایوڈیشن اور لوجز ہو۔
• پروفائڈر اور گیتوی کی شراکت اور کارروائی کے لیے کارروائی کی پیمائیں۔

ریلیز سے پہلے انٹگریشن ریکارڈ کریں

ریلیز سے پہلے تاریخ، کارکنڈ ورژن، مودل آئی ڈی، انڈپنڈنٹ، اسٹٹس اور آپ نے کیا ٹیسٹ کیا وہی لکھیں۔ اگر کوئی ٹیسٹ نہیں کیا گیا تو اسے غیر چیک کر دیا جاسکا۔

یہ ریکارڈ اگلے مودل یا گیتوی اپ ڈیٹ کو سمجھنے میں آسان بنائے گا اور ایک قدیم بلو گیم کا پروڈکشن میں غیر مدعوم ہونے کا خطرہ کم کرے گا۔

سوال و جواب

یہ DeepSeek کی رسمی ایپائی انڈپنڈنٹ ہے؟

ہاں نہیں۔ یہ آرٹیکل ECAIX گیتوی کے مودل آئی ڈی کو ECAIX کیٹالگ میں فراہم کیا گیا ہے۔ DeepSeek کی نیشنل انڈپنڈنٹ ایپائی ڈاکیمنٹیشن ہے DeepSeek کے اکاؤنٹ کے قاعدے اور پروفائڈر کے خاص قابلیتوں کے لیے۔

میرا اپلیکیشن کو OpenAI SDK کے ساتھ دوبارہ لکھنا ضروری ہے؟

کئی OpenAI SDK اپلیکیشنوں کو بیس آئی ڈی، ایپائی کیز اور مودل آئی ڈی کو تبدیل کرنے سے شروع کیا جا سکتا ہے۔ تاہم، آپ کو فیلڈ کی مدعومیت، سٹریمنگ، ٹول کولز، رپونز فارمٹ، خطا ہینڈلنگ اور اپنے اپلیکیشن میں استعمال ہونے والے کسی پروفائڈر کے خاص فیچرز کے بارے میں ٹیسٹ کرنا ہوگا۔

کیا میں DeepSeek کا مودل چیکنا چاہوں گا؟

مودل ڈائریکٹری سے شروع کریں اور کام کے لیے انتخاب کریں: کڈنگ، ریزوننگ، کنٹیکسٹ لنگتھ، مموڈل انپٹ، یا پریسنگ کی ضرورت۔ ایک قدیم آرٹیکل سے نام کا کپی کر کے نہیں۔ موجودہ مودل آئی ڈی چیک کریں اور اپنے پرومپٹس کے خلاف ٹیسٹ کریں۔

میرا کلاڈ کڈ کے ساتھ یہ کارروائی کیا جا سکتا ہے؟

Anthropic سٹائل پیمائنا کو ایک ٹرائیڈ پارٹی پروفائڈر کے طور پر ٹیسٹ کیا جا سکتا ہے، لیکن Anthropic نے گیتوی کے ذریعے کلاڈ کڈ کو غیر کلاڈ مودلز کو روٹنگ کرنے کی حمایت نہیں دی۔ یہ نہیں ظاہر کریں کہ یہ Anthropic کی رسمی حمایت ہے یا کلاڈ کڈ کی مکمل قابلیت کا گارنٹی ہے۔

کیا میں پریسنگ اور محدودیاں چیک کرنے کے لیے یہاں سے کڈ کر سکتا ہوں؟

ECAIX پریسنگ پیج، مودل ڈائریکٹری اور آپ کا اکاؤنٹ کنٹرولز چیک کریں۔ یہ آرٹیکل میں اپلیکیشن میں ہارڈ کڈ کرنے سے اجتناب کریں۔

اگلے قدم

1. موجودہ DeepSeek مودل پیج میں مودل آئی ڈی چیک کریں۔
2. ECAIX ایپائی کیز بنائیں۔
3. چٹ چیلنجز ڈاکیمنٹیشن پڑھیں۔
4. ڈائریکٹ کول ڈاگناسٹک چیک کریں۔
5. ڈائریکٹ ریکارڈ کامیاب ہو جانے کے بعد صرف SDK کے مثال کو چیک کریں۔
6. سٹریمنگ، JSON، یا ٹولز ایک فیچر ایک وقت پر شامل کریں۔

سورس

• DeepSeek ایپائی ڈاکیمنٹیشن
• ECAIX چٹ چیلنجز ڈاکیمنٹیشن
• ECAIX رپونز ڈاکیمنٹیشن
• ECAIX Anthropic مساجز ڈاکیمنٹیشن