---
title: "Pydantic AI میں کسٹم OpenAI-compatible base_url | BroadRouter"
description: "OpenAIChatModel اور OpenAICompatibleProvider سے BroadNet Inference پر Pydantic AI ایجنٹس چلائیں، ساتھ میں ٹول کالز، اسٹرکچرڈ آؤٹ پٹ اور ماڈل پروفائل کے حل۔"
url: https://broadrouter.com/ur/guides/pydantic-ai-openai-compatible/
lang: ur
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

یہ صفحہ انگریزی سے AI کی مدد سے ترجمہ کیا گیا ہے۔ [انگریزی اصل پڑھیں](https://broadrouter.com/guides/pydantic-ai-openai-compatible/) (اپ ڈیٹ: 2026-11-16).

# BroadNet Inference کے ساتھ Pydantic AI (OpenAICompatibleProvider)

اپ ڈیٹ 2026-11-16

pydantic-ai-slim\[openai\] انسٹال کریں، پھر broadnet/glm-5.3 جیسے BroadNet ماڈل ID اور ایسے OpenAICompatibleProvider کے ساتھ OpenAIChatModel بنائیں جس کا base URL https://inference.broadnet.ai/v1 اور API کلید آپ کی BroadNet کلید ہو۔ ماڈل کو Agent میں دیں۔ Responses ماڈل نہیں، OpenAIChatModel استعمال کریں، کیونکہ BroadNet چیٹ کمپلیشنز فراہم کرتا ہے۔ Pydantic AI کی دستاویزات کہتی ہیں کہ base\_url والا OpenAIProvider خود OpenAI کے لیے ہے۔

Pydantic AI، Pydantic ٹیم کا Python ایجنٹ فریم ورک ہے۔ جس سروس کے لیے اس میں بلٹ اِن پرووائیڈر نہیں، اس کے لیے اس کی دستاویزات اس سروس کے `base_url` کے ساتھ `OpenAICompatibleProvider` استعمال کرنے کو کہتی ہیں۔ BroadNet Inference، `https://inference.broadnet.ai/v1` پر معیاری چیٹ کمپلیشنز فراہم کرتا ہے، اس لیے یہی راستہ ہے۔ BroadRouter، BroadNet کی اپنی سائٹ ہے۔ یہ گائیڈ ورژن 2.68 کے وقت کی Pydantic AI دستاویزات کے مطابق ہے۔

## انسٹال کریں

```bash
pip install "pydantic-ai-slim[openai]"
export BROADNET_API_KEY='your-broadnet-key'
```

## کنیکٹ کریں

```python
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai_compatible import OpenAICompatibleProvider

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider(
        'broadnet',
        base_url='https://inference.broadnet.ai/v1',
        api_key=os.environ['BROADNET_API_KEY'],
    ),
)

agent = Agent(model)
result = agent.run_sync('Give me three names for a Go linting tool.')
print(result.output)
```

اسے چلانا ہی ٹیسٹ ہے: جواب پرنٹ ہو جائے تو کلید، URL اور ماڈل ID درست ہیں۔

-   **پہلا آرگیومنٹ ماڈل ID ہے** جو BroadNet کو بھیجا جاتا ہے۔ اسے بالکل ویسا ہی، `broadnet/` پری فکس کے ساتھ استعمال کریں۔
-   **پرووائیڈر کا نام** (یہاں `'broadnet'`) ہر رسپانس پر درج ہوتا ہے۔ Pydantic AI کی دستاویزات اسے مستقل رکھنے کو کہتی ہیں، کیونکہ اسی سے طے ہوتا ہے کہ پچھلے رسپانسز کا کون سا ڈیٹا سروس کو واپس بھیجا جائے۔
-   **`OpenAIChatModel` پر ہی رہیں۔** Pydantic AI کی دستاویزات کہتی ہیں کہ `OpenAIResponsesModel` صرف تب استعمال کریں جب سروس Responses API نافذ کرتی ہو۔ BroadNet اسے درج نہیں کرتا۔

## ٹولز اور اسٹرکچرڈ آؤٹ پٹ

```python
from pydantic import BaseModel

class City(BaseModel):
    name: str
    country: str

agent = Agent(model, output_type=City)
print(agent.run_sync('Which city hosts the Burj Khalifa?').output)
```

ٹولز اور اسٹرکچرڈ آؤٹ پٹ کے لیے `broadnet/glm-5.3` یا `broadnet/qwen3.8-27b` استعمال کریں؛ BroadNet کی دستاویزات یہ دونوں فیچرز صرف انہی دو ماڈلز کے لیے درج کرتی ہیں۔

## ماڈل پروفائل کب سیٹ کریں

Pydantic AI ماڈل کے نام سے درخواست کی پروفائل چنتا ہے۔ اگر کوئی فیچر نظرانداز ہو یا مسترد ہو تو اس کی دستاویزات اپنی `OpenAIModelProfile` دینے کو کہتی ہیں۔ BroadNet کے لیے دو سیٹنگز جاننے کے قابل ہیں:

```python
from pydantic_ai.profiles.openai import OpenAIModelProfile

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider('broadnet', base_url='https://inference.broadnet.ai/v1', api_key=os.environ['BROADNET_API_KEY']),
    profile=OpenAIModelProfile(
        openai_chat_supports_max_completion_tokens=False,  # send max_tokens, the field BroadNet documents
        openai_supports_strict_tool_definition=False,      # only if strict tool schemas are rejected
    ),
)
```

آؤٹ پٹ کی حد ماڈل سیٹنگز کے ذریعے دیں، مثلاً `agent.run_sync(prompt, model_settings={'max_tokens': 2000})`۔ DeepSeek V4.1 Flash، GLM 5.3 اور Qwen3.8 27B پر ریزننگ اس میں گنی جاتی ہے۔

## کون سا ماڈل چنیں

| ایجنٹ | ماڈل |
| --- | --- |
| ٹولز، اسٹرکچرڈ آؤٹ پٹ | `broadnet/glm-5.3` |
| ٹولز کے ساتھ امیجز یا عربی متن | `broadnet/qwen3.8-27b` |
| لمبی دستاویزات، مقررہ قیمت والا پلان | `broadnet/deepseek-v4.1-flash` |
| مفت ابتدائی کریڈٹ | `broadnet/gemma-4-26b-a4b` (32,768 ٹوکن کا کانٹیکسٹ) |

[ہر ماڈل کی قیمتیں](https://broadrouter.com/ur/pricing/)۔

## مسائل کا حل

-   **401۔** کلید غلط ہے، اس کی میعاد ختم ہو گئی ہے یا الاؤنس ختم ہو گیا ہے۔
-   **404 یا ماڈل نہیں ملا۔** `base_url` کے آخر میں `/v1` ہونا چاہیے۔ ماڈل ID جانچیں۔ پیڈ ماڈلز کے لیے ٹاپ اپ چاہیے؛ $5 کریڈٹ صرف `broadnet/gemma-4-26b-a4b` اور دو Transcribe ماڈلز کو کور کرتا ہے۔
-   **خالی آؤٹ پٹ یا ویلیڈیشن ری ٹرائی کا لوپ۔** ریزننگ نے آؤٹ پٹ بجٹ خرچ کر دیا۔ `max_tokens` بڑھائیں۔ [جوابات خالی کیوں آتے ہیں](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)۔
-   **ٹول ڈیفینیشنز پر 400۔** پروفائل میں `openai_supports_strict_tool_definition=False` سیٹ کریں، اور ایسا ماڈل استعمال کریں جسے BroadNet ٹولز کے ساتھ درج کرتا ہے۔
-   **ایجنٹس بیک وقت چلانے پر 429۔** استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں اور بیک وقت 4 جاری درخواستوں کی اجازت دیتی ہے۔ [ایررز اور دوبارہ کوشش](https://broadrouter.com/ur/guides/errors-and-retries/) دیکھیں۔

## اس گائیڈ کی اصطلاحات

[استعمال کے مطابق ادائیگی (pay-as-you-go)](https://broadrouter.com/ur/glossary/pay-as-you-go/)

استعمال کے مطابق ادائیگی (pay-as-you-go) قیمت طے کرنے کا ایک ماڈل ہے جس میں آپ صرف اتنا دیتے ہیں جتنا استعمال کرتے ہیں، ٹوکن، درخواستوں یا آڈیو منٹ جیسی اکائیوں میں ناپ کر، بغیر سبسکرپشن یا کم از کم وابستگی کے۔ زیادہ تر LLM API اسی طرح بل بناتے ہیں، پری پیڈ بیلنس یا وقتاً فوقتاً بننے والی انوائس سے۔

[اسٹرکچرڈ آؤٹ پٹ (structured output)](https://broadrouter.com/ur/glossary/structured-output/)

اسٹرکچرڈ آؤٹ پٹ LLM API کا ایک فیچر ہے جو ماڈل کے جواب کو ڈویلپر کے طے کردہ فارمیٹ، عموماً JSON Schema، تک محدود کرتا ہے، تاکہ کوڈ اسے قابلِ اعتماد طریقے سے پارس کر سکے۔ یہ JSON mode سے زیادہ سخت ہے، جو درست JSON کی ضمانت دیتا ہے، لیکن کسی خاص ساخت کی نہیں۔

[کنکرنسی (concurrency)](https://broadrouter.com/ur/glossary/concurrency/)

کنکرنسی، کسی کلائنٹ کی بیک وقت چل رہی (in-flight) درخواستوں کی تعداد ہے۔ LLM APIs اکثر اس کی حد ہر کلید یا پلان پر، فی منٹ درخواستوں سے الگ رکھتے ہیں، کیونکہ ہر کھلی درخواست جواب مکمل ہونے تک GPU کی گنجائش گھیرے رکھتی ہے۔

[AI ایجنٹ (AI agent)](https://broadrouter.com/ur/glossary/agent/)

AI ایجنٹ ایسا نظام ہے جس میں لینگویج ماڈل کسی ہدف کی طرف اپنے قدم خود طے کرتا ہے: کون سے ٹولز کال کرنے ہیں، یہ چنتا ہے، نتائج پڑھتا ہے اور حتمی جواب یا کسی حد تک دہراتا رہتا ہے۔ مقررہ مقامات پر ماڈل کو کال کرنے والی اسکرپٹ کو عموماً workflow کہا جاتا ہے۔

[پری پیڈ کریڈٹ (prepaid credit)](https://broadrouter.com/ur/glossary/prepaid-credit/)

پری پیڈ کریڈٹ وہ رقم ہے جو استعمال سے پہلے API اکاؤنٹ میں ڈالی جاتی ہے۔ ہر درخواست کی لاگت بیلنس سے کٹتی ہے، اور بیلنس ختم ہونے پر میٹر والی درخواستیں تب تک رک جاتی ہیں جب تک آپ ٹاپ اپ نہ کریں۔ اس سے خرچ اتنا ہی رہتا ہے جتنا آپ نے جمع کیا ہے۔

[ٹوکن (token)](https://broadrouter.com/ur/glossary/token/)

ٹوکن متن کی وہ اکائی ہے جسے لینگویج ماڈل پڑھتا اور لکھتا ہے: کوئی لفظ، لفظ کا حصہ، رموزِ اوقاف کی کوئی علامت یا بائٹس کا سلسلہ، جو ماڈل کا ٹوکنائزر بناتا ہے۔ LLM API استعمال کو ٹوکنز میں گنتے ہیں، انہی میں حدیں لگاتے ہیں اور عموماً بل بھی بناتے ہیں۔

[ریٹ لمٹ (rate limit)](https://broadrouter.com/ur/glossary/rate-limit/)

ریٹ لمٹ وہ حد ہے جو کوئی API طے کرتا ہے کہ ایک کلائنٹ کسی مدت میں اسے کتنا استعمال کر سکتا ہے، جیسے فی منٹ درخواستیں یا فی منٹ ٹوکن۔ حد سے زیادہ درخواستیں رد کر دی جاتی ہیں، عموماً HTTP 429 Too Many Requests کے ساتھ، جب تک استعمال دوبارہ حد سے نیچے نہ آ جائے۔

## عام سوالات

### BroadNet کے لیے OpenAIProvider استعمال کروں یا OpenAICompatibleProvider؟

OpenAICompatibleProvider۔ Pydantic AI کی دستاویزات کہتی ہیں کہ OpenAIProvider بھی base\_url لیتا ہے، لیکن وہ خود OpenAI یا اس تک جانے والی transparent proxy کے لیے ہے، اور OpenAI کے ماڈلز اور فیچرز فرض کر کے چلتا ہے۔

### ڈیفالٹ OpenAI ماڈل کی جگہ OpenAIChatModel کیوں؟

Pydantic AI کا ڈیفالٹ OpenAI ماڈل Responses API استعمال کرتا ہے۔ BroadNet، /v1/chat/completions پر چیٹ کمپلیشنز فراہم کرتا ہے، اور OpenAIChatModel یہی کال کرتا ہے۔

### کیا ٹولز اور اسٹرکچرڈ آؤٹ پٹ کام کرتے ہیں؟

ہاں، ان ماڈلز پر جنہیں BroadNet ٹولز اور اسٹرکچرڈ آؤٹ پٹ کے ساتھ درج کرتا ہے: GLM 5.3 اور Qwen3.8 27B۔ BroadNet کی دستاویزات DeepSeek V4.1 Flash کے لیے ٹولز درج نہیں کرتیں، اس لیے ٹولز والے ایجنٹس پہلے اس پر ٹیسٹ کریں۔

### Pydantic AI کو max\_completion\_tokens بھیجنے سے کیسے روکوں؟

OpenAIChatModel کو profile=OpenAIModelProfile(openai\_chat\_supports\_max\_completion\_tokens=False) دیں۔ تب Pydantic AI پرانا max\_tokens فیلڈ بھیجتا ہے، جو BroadNet کا API ریفرنس بیان کرتا ہے۔

## متعلقہ گائیڈز

-   [BroadNet Inference کے ساتھ OpenAI Python SDK استعمال کریں](https://broadrouter.com/ur/guides/openai-python-sdk/)
-   [BroadNet Inference کے ساتھ LangChain استعمال کریں](https://broadrouter.com/ur/guides/langchain-openai-base-url/)
-   [CrewAI میں BroadNet Inference کو کسٹم OpenAI اینڈ پوائنٹ بنائیں](https://broadrouter.com/ur/guides/crewai-custom-openai-endpoint/)
-   [ریزننگ ماڈل خالی جواب کیوں لوٹاتا ہے](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference کے ساتھ کام کرنے والے تمام ٹولز (انگریزی میں)](https://broadrouter.com/integrations/): SDKs، کوڈنگ ایجنٹس، چیٹ انٹرفیس اور آٹومیشن ٹولز، ہر ایک کی درست سیٹنگز کے ساتھ

اسے اپنے اصل کام پر آزمائیں۔ نئے اکاؤنٹس Gemma اور ٹرانسکرپشن کے لیے US$5 کے کریڈٹ سے شروع ہوتے ہیں۔ DeepSeek، GLM، اور Qwen3.8 کے لیے ٹاپ اپ ضروری ہے۔

[شروع کریں](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-pydantic-ai-openai-compatible&utm_content=page-cta) ·

**ذرائع**

-   [Pydantic AI دستاویزات، Other compatible APIs (Other endpoints، Model profile) (2026-11-15 کو جانچا گیا)](https://pydantic.dev/docs/ai/models/compatible-apis/)
-   [Pydantic AI دستاویزات، OpenAI models (2026-11-15 کو جانچا گیا)](https://pydantic.dev/docs/ai/models/openai/)
-   [PyPI، pydantic-ai 2.68.0، Python 3.11+ (2026-11-15 کو جانچا گیا)](https://pypi.org/project/pydantic-ai/)
-   [BroadNet Inference API ریفرنس (2026-11-15 کو جانچا گیا) (انگریزی میں)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-pydantic-ai-openai-compatible&utm_content=sources)
