تبدیلیوں کا لاگ

web_search: true والی درخواست اپنے ذرائع بتاتی ہے: /v1/chat/completions اور /v1/messages پر sources ماڈل کو دیے گئے نتائج کی فہرست دیتا ہے، اور /v1/chat/completions پر annotations نشان زد کرتا ہے کہ جواب ہر ایک کا حوالہ کہاں دیتا ہے۔ ویب تلاش

/v1/chat/completions اور /v1/messages پر web_search: true ماڈل کے جواب دینے سے پہلے ویب سرچ چلاتا ہے اور نتائج اسے نمبر شدہ ذرائع کے طور پر دیتا ہے۔ جس درخواست کو نتائج ملیں وہ آپ کے روزانہ الاؤنس کی ایک سرچ استعمال کرتی ہے۔ کوئی سرچ باقی نہ ہو تو درخواست کا جواب سرچ کے بغیر دیا جاتا ہے۔ ویب تلاش

سرور کی طرف سے کٹ جانے والی سٹریم کا بل اس مقام تک رپورٹ ہونے والے usage پر بنتا ہے۔ محفوظ کی گئی باقی مقدار آپ کے بیلنس میں واپس آ جاتی ہے۔

shannon-coder-1 /v1/responses پر ویسے ہی جواب دیتا ہے جیسے باقی دو endpoints پر۔ CLI کوڈنگ ٹولز

rotate کی گئی API کلید فوراً کام کرنا بند کر دیتی ہے۔

POST /v1/tokenize اور POST /v1/messages/count_tokens: ہوسٹڈ اوپن ویٹ ماڈلز کے لیے مفت ٹوکن گنتی۔ ٹوکن گنتی

ہوسٹڈ اوپن ویٹ ماڈلز پر پرامپٹ کیشنگ۔ کیشڈ ان پٹ کا بل ان پٹ قیمت کے 25% پر بنتا ہے اور تینوں endpoints پر usage میں رپورٹ ہوتا ہے: prompt_tokens_details.cached_tokens، input_tokens_details.cached_tokens اور cache_read_input_tokens۔ GET /v1/models ان ماڈلز کے لیے pricing.cached_input_per_million_usd اور capabilities.prompt_caching بتاتا ہے۔ پرامپٹ کیشنگ

ہوسٹڈ اوپن ویٹ ماڈلز: لازمی tool_choice (required یا نام والا فنکشن) ٹول کال دیتا ہے۔ فنکشن کالنگ

ہوسٹڈ اوپن ویٹ ماڈلز ایسا system پیغام قبول کرتے ہیں جو گفتگو کا پہلا پیغام نہ ہو۔

API Tor onion سروس کے طور پر اور ایک I2P پتے پر دستیاب ہے۔ api.shannon-ai.com کے جوابات Onion-Location اور X-I2P-Location ہیڈرز میں دونوں پتے رکھتے ہیں۔ انکرپٹڈ، Tor اور I2P اینڈ پوائنٹس

نئے ماڈلز shannon-3.1 اور shannon-3.1-pro، جو GET /v1/models میں درج ہیں۔ ماڈلز اور قیمتیں

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

/v1/responses کی درخواستیں usage لاگ میں نظر آتی ہیں۔

ہوسٹڈ اوپن ویٹ ماڈلز سیمپلنگ فیلڈز لاگو کرتے ہیں: /v1/chat/completions پر temperature، top_p، seed، stop اور max_tokens؛ /v1/messages پر temperature، top_p اور stop_sequences؛ /v1/responses پر temperature، top_p اور max_output_tokens۔ Chat Completions

usage لاگ ہر کال کے لیے اور مجموعی طور پر USD میں لاگت دکھاتا ہے۔

ایسی model قدر جو شائع شدہ id نہ ہو، تینوں endpoints پر 400، type invalid_request_error اور پیغام unknown model: <id> سے جواب پاتی ہے۔ پہلے ایسی درخواست کا جواب shannon-1.6-lite دیتا تھا۔ ماڈلز اور قیمتیں

/v1 صرف API کلید لیتا ہے۔ ویب سائٹ کی سائن ان کوکی وہاں نہیں پڑھی جاتی۔ توثیق

Flood protection: تینوں generation endpoints پر فی اکاؤنٹ 120 درخواستیں فی منٹ۔ حدود اور بیلنس

جب ماڈل جواب نہ دے سکے تو ایرر میں مقررہ پیغام The model backend failed to answer. Please retry. ہوتا ہے۔ جو بیلنس چیک نہ ہو سکے اس کا جواب 503 اور type api_error سے دیا جاتا ہے۔ غلطیاں

ناکام ہونے والی غیر سٹریم درخواست اپنی محفوظ کی گئی مقدار آپ کے بیلنس میں واپس کر دیتی ہے۔

GET /v1/models ہر ماڈل کے لیے capabilities.reasoning_effort بتاتا ہے۔ Reasoning effort

ہوسٹڈ اوپن ویٹ ماڈلز: جس غیر سٹریم درخواست کو جواب نہ ملے وہ 504 اور type api_error پر ختم ہوتی ہے۔ خالی نتیجہ 502 ہے۔ غلطیاں

ہوسٹڈ اوپن ویٹ ماڈلز وہی ان پٹ لیتے ہیں جو نام والا ماڈل لیتا ہے۔ صرف متن والے id کو بھیجی گئی تصویر کا جواب 400 اور <id> does not accept image input سے دیا جاتا ہے۔ ساختی آؤٹ پٹ کے بغیر id پر response_format کا جواب 400 ہوتا ہے۔ GET /v1/models ہر id کے لیے capabilities.vision، response_format اور json_schema بتاتا ہے۔ تصاویر اور فائلیں

غیر سٹریم جوابات reasoning متن رکھتے ہیں: /v1/chat/completions کے پیغام پر reasoning_content، اور /v1/messages پر متن سے پہلے thinking بلاک۔ Reasoning effort

ہوسٹڈ اوپن ویٹ ماڈلز کی نئی قیمتیں، $0.50 فی 1M ان پٹ ٹوکنز اور $2.00 فی 1M آؤٹ پٹ ٹوکنز سے شروع۔ ماڈلز اور قیمتیں

ہوسٹڈ اوپن ویٹ ماڈلز کا ہر ماڈل کے لیے ایک id ہے، کل بارہ ids۔ ماڈلز اور قیمتیں

shannon-3، shannon-3-pro، shannon-3.1 اور shannon-3.1-pro پر ساختی آؤٹ پٹ۔ GET /v1/models ان کے لیے capabilities.json_schema: true بتاتا ہے۔ ساختی آؤٹ پٹس

/v1/responses ساختی آؤٹ پٹ کے لیے text.format (json_object یا json_schema) پڑھتا ہے۔ Responses API

/v1/responses Shannon ماڈلز کی reasoning لوٹاتا ہے: message آئٹم سے پہلے ایک reasoning آؤٹ پٹ آئٹم، اور سٹریم ایونٹس response.reasoning_summary_text.delta اور response.reasoning_summary_text.done۔ Responses API

جواب کا model فیلڈ ہر endpoint پر شائع شدہ id ہوتا ہے۔ Responses آبجیکٹ میں model اور created_at ہوتے ہیں۔

GET /v1/models ہر ماڈل کی کانٹیکسٹ ونڈو بتاتا ہے۔ ماڈلز اور قیمتیں

ہوسٹڈ اوپن ویٹ ماڈلز /v1/chat/completions کے ساتھ ساتھ /v1/messages اور /v1/responses پر بھی جواب دیتے ہیں، آپ کے سسٹم پرامپٹ اور ٹول کالز کے ساتھ۔ /v1/messages thinking لیتا ہے، اور reasoning_effort درخواست کا فیلڈ ہے۔ ماڈلز اور قیمتیں

/v1 پر ایرر باڈیز SDK کی شکلوں کی پیروی کرتی ہیں: OpenAI فارمیٹ والے endpoints پر type اور message کے ساتھ error آبجیکٹ، اور /v1/messages پر وہی آبجیکٹ {"type": "error"} کے اندر۔ غلطیاں

کھلی سٹریمز پر ہر 15 سیکنڈ بعد keep-alive: /v1/chat/completions پر : ping تبصرے والی لائن، /v1/messages پر event: ping۔ اسٹریمنگ

ٹول کال ids /v1/chat/completions اور /v1/responses پر call_ سے اور /v1/messages پر toolu_ سے شروع ہوتے ہیں۔ فنکشن کالنگ

/v1/responses: stream کی ڈیفالٹ قدر false ہے۔ Responses API

/v1/chat/completions پر max_completion_tokens کو max_tokens کے دوسرے نام کے طور پر قبول کیا جاتا ہے۔ Chat Completions

Responses سٹریم کے response.completed ایونٹ میں output ارے ہوتی ہے۔ Responses API

GET /v1/models کی اندراجات میں display_name، context_window، max_output_tokens، pricing، capabilities اور endpoints ہوتے ہیں۔ ماڈلز اور قیمتیں

ہر جواب x-request-id رکھتا ہے، اور آپ کی بھیجی ہوئی قدر واپس کی جاتی ہے۔ درخواست کی باڈیز 32 MiB تک ہو سکتی ہیں۔

کلید کو نئی کلید جاری کیے بغیر منسوخ کیا جا سکتا ہے۔ usage لاگ صفحہ بہ صفحہ دکھایا جاتا ہے۔

درخواستوں میں تصاویر اور دستاویزات: /v1/chat/completions پر image_url حصے، /v1/messages پر image، document اور file بلاکس، /v1/responses پر input_image حصے۔ تصاویر اور فائلیں

نیا ماڈل shannon-3-pro۔ ماڈلز اور قیمتیں

نیا ماڈل shannon-3۔ ماڈلز اور قیمتیں

/v1/chat/completions کی سٹریمز reasoning کو delta.reasoning_content کے طور پر لاتی ہیں۔ Reasoning effort

max_tokens کو 1 سے 65,536 کے اندر رکھا جاتا ہے۔ اس دائرے سے باہر کی قدر قریب ترین سرے پر لے آئی جاتی ہے، مسترد نہیں کی جاتی۔ Chat Completions

/v1/chat/completions اور /v1/messages پر shannon-coder-1 کو فی پلان کالز میں گنا جاتا ہے۔ جب ونڈو کی کالز ختم ہو جائیں تو جواب 429 ہوتا ہے اور پیغام Shannon Coder call quota reached ہوتا ہے۔ CLI کوڈنگ ٹولز

کانٹیکسٹ ونڈو سے بڑی گفتگو کا جواب 400، type invalid_request_error اور code context_length_exceeded سے دیا جاتا ہے۔ سٹریم کے اندر کا ایرر ایرر ایونٹ کے طور پر آتا ہے، جواب میں متن کے طور پر نہیں۔ CLI کوڈنگ ٹولز

/v1 endpoints: POST /v1/chat/completions، POST /v1/messages، POST /v1/responses اور GET /v1/models۔ یہ وہ endpoints ہیں جنہیں OpenAI اور Anthropic SDKs، Claude Code اور Codex CLI کال کرتے ہیں۔ جائزہ

/v1/chat/completions اور /v1/messages پر tools کے ساتھ ٹول کالز، response_format کے ساتھ ساختی آؤٹ پٹ، اور /v1/messages پر system سٹرنگ یا ٹیکسٹ بلاکس کے طور پر۔ فنکشن کالنگ

ماڈل ids shannon-1.6-pro، shannon-2-lite، shannon-2-pro اور shannon-coder-1، shannon-1.6-lite کے ساتھ۔ ماڈلز اور قیمتیں

API کا پہلا ریلیز: OpenAI فارمیٹ اور Anthropic فارمیٹ میں چیٹ، اور ایک Responses endpoint، ہر ایک sk- سے شروع ہونے والی API کلید کے ساتھ کال ہوتا ہے۔ توثیق