د API لوبې ډګر

متقابل عمل

هر ماډل او endpoint په براوزر کې د خپلې کیلي سره وازمایئ — د streaming output، د غوښتنې معاینه کوونکی، او جوړ شوی کوډ چې تاسو یې مستقیم خپلې اپلیکیشن ته پیسټ کولی شئ.

Playground پیل کړئ

Playground د API لپاره د چیټ کنسول دی په /docs/playground. تاسو له ماډل سره خبرې کوئ، او playground هماغه غوښتنې لیږي چې ستاسو کوډ به یې لیږي: د درې endpoints څخه یو ته، د هغه ماډل، system prompt، پارامیټرونو او tools سره چې تاسو یې ټاکلي. هره غوښتنه د کوډ او خام stream رخدادونو په توګه بیرته لوستل کیدی شي.

پیل

کیلي ورکړئ — کله چې ننوتلی یاست، playground ستاسو د حساب API کیلي کاروي او ستاسو بیلانس ښیي. کله چې نه یاست ننوتلی، Add key غوره کړئ او کیلي پیسټ کړئ: دا یوازې په دې ټب کې ساتل کیږي او هیڅکله نه خوندي کیږي.
Endpoint او ماډل غوره کړئ — پورتنۍ بار د endpoint سویچ او د ماډل غوره کوونکی لري. نوې ګفتګه په Chat Completions کې د shannon-3 سره پیلیږي.
پیغام ولیږئ — لاندې ټایپ کړئ او Enter کېکاږئ. هر ځواب ګفتګې سره یوځای کیږي، نو راتلونکی پیغام ورته دوام ورکوي. خالي سکرین درې پیل prompts او چمتو tool-call بېلګه وړاندې کوي.

تاسو خپله کیلي د Keys & usage په پاڼه کې موندلی او بدلولی شئ. کیلي او کارونه

Endpoints او ماډلونه

د endpoint سویچ پریکړه کوي چې playground کومه د غوښتنې بڼه جوړوي. تاسو کولی شئ دا د ګفتګې په منځ کې بدل کړئ؛ پیغامونه پاتې کیږي.

Endpoint	غوښتنه چې لیږي	مرجع
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	انتروپيک بڼه

د ماډل غوره کوونکی هغه لیست کوي چې GET /v1/models بیرته ورکوي. دا لټول کیدی شي، ستاسو وروستي ماډلونه په سر کې ساتي، او د هر ماډل لپاره د 1M ټوکنونو نرخ، context window او د tools، انځور input، reasoning او جوړښت لرونکي output نښې ښیي.

ګفتګه

ځوابونه په ګفتګه کې په stream کیږي پداسې حال کې چې لیکل کیږي. د ماډل reasoning په جلا block کې ښودل کیږي چې تاسو یې فولډ کولی شئ.
د هر ځواب لاندې: لومړي ټوکن ته وخت، په ثانیه کې ټوکنونه، تېر شوی وخت، input او output ټوکنونه د cached او reasoning برخو سره، د turn د لګښت اټکل، د پای دلیل او د ځواب id.
ستاسو پیغام د هغه ځای څخه سمول او بیا لیږل کیدی شي. ځواب بیا جوړیدی شي. پیغام ړنګیدی شي، او ړنګول د څو ثانیو لپاره بیرته اخیستل کیدی شي.
Stop یا Esc کیلي هغه ځواب پای ته رسوي چې لیکل کیږي.
انځورونه د انځور تڼۍ، پیسټ کولو یا د فایل غورځولو په واسطه ضمیمه کیږي، د هغو ماډلونو لپاره چې انځورونه مني. انځور مخکې له لیږلو په اوږده څنډه کې 1,568 پکسل ته کوچنی کیږي. فایل چې له 30 MB زیات وي پرېښودل کیږي.
Composer او system prompt د ټوکنونو شمیر ښيي. د کوربه شوو open-weight ماډلونو لپاره دا له POST /v1/tokenize څخه دقیقه شمیره ده. د نورو ماډلونو لپاره دا اټکل دی، چې په ≈ نښه شوی.
ناکامه غوښتنه ښیي چې بیا څه وکړئ: کیلي وټاکئ کله چې کیلي رد شوې وي، کریډیټ اضافه کړئ کله چې بیلانس ختم شوی وي، د انتظار ثانیې وروسته له ډیرو غوښتنو، یا د server تېروتنې وروسته بیا هڅه.

د غوښتنې تنظیمات

د Settings تڼۍ د شپږو ټبونو سره پینل پرانیزي. تنظیمات د ګفتګې دي: هره ګفتګه خپل ساتي.

ټب	څه لري
System	د ګفتګې system prompt، له هرې غوښتنې سره لیږل کیږي. پنځه templates یې ډکوي، او د ټوکنونو شمیر یې ښودل کیږي.
پارامیټرونه	اعظمي output ټوکنونه، temperature، `top_p`، reasoning effort، د ودرولو ترتیبونه، `seed`، او د streaming او web search سویچونه. کنټرول چې ټاکل شوی endpoint ورته ساحه نه لري بند او نښه کیږي.
Tools	د tool تعریفونه چې له غوښتنې سره لیږل کیږي: څلور مخکې جوړ شوي (`get_weather`، `read_file`، `run_shell`، `web_search`) یا ستاسو خپل تعریف د JSON په توګه، او `tool_choice` (`auto`، `none`، `required` یا یو tool د نوم په واسطه). کله چې ماډل tool غواړي، ګفتګه call د پایلې لپاره د بکس سره ښيي. کله چې Offer sample results فعال وي، یو کلیک نمونه پایله ډکوي. تاسو کولی شئ خپله هم ټایپ کړئ، بیا یې ولیږئ ترڅو turn دوام ومومي.
جوړښت لرونکی	`response_format`: `text`، `json_object` یا `json_schema` د schema نوم او JSON schema سره. کله چې schema ټاکل شوې وي، وروستی ځواب د هغې پر ضد چک کیږي او په ګفتګه کې د سمون یا نه سمون په توګه نښه کیږي. ټب په Messages endpoint کې بند دی، او اختیار چې ټاکل شوی ماډل یې نه مني نه وړاندې کیږي.
کوډ	د اوسنۍ ګفتګې غوښتنه د cURL، Python، Node یا Go کوډ په توګه، چې له ګفتګې او تنظیماتو جوړه شوې. کیلي د `YOUR_API_KEY` په توګه چاپیږي. کوډ کاپي کیدی شي یا په لوی لید کې پرانیستل کیدی شي.
رخدادونه	وروستی turn هماغسې لکه په تار کې چې تېر شو: هر stream رخداد د خپل وخت offset او فلټر سره، راټول شوی ځواب، د ځواب headers (`x-request-id`، `content-type`، `retry-after`، `date`) او د غوښتنې بدنه. دا تر پاڼې بیا بارولو پورې ساتل کیږي.

د input چکونه

هغه ارزښتونه چې تاسو یې ټایپ کوئ مخکې له غوښتنې لیږلو چک کیږي. له لړۍ بهر ارزښت په خپله ساحه کې نښه کیږي، او لیږل تر سمولو پورې ودرول کیږي.

تنظیم	چک
اعظمي output ټوکنونه	بشپړ عدد له 1 څخه تر د ماډل `max_output_tokens` پورې.
Temperature	عدد له 0 څخه تر 2 پورې. خالي ساحه له غوښتنې بهر پریږدي.
`top_p`	عدد له 0 څخه تر 1 پورې. خالي ساحه له غوښتنې بهر پریږدي.
`seed`	بشپړ عدد.
د ودرولو ترتیبونه	تر 4 پورې، د کامو سره جلا شوي.
`response_format`	باید هغه وي چې ټاکل شوی ماډل یې مني. هغه ګفتګه چې ماډل ته لیږدول شوې چې `json_schema` یا `response_format` نه لري د دلیل سره ودرول کیږي.
انځورونه	کله چې هغه ماډل ته بدل شئ چې یوازې متن مني له پیغام څخه لرې کیږي، د یادښت سره.

دوه ماډلونه پرتله کړئ

په More مینو کې دوه ماډلونه پرتله کړئ دویم ماډل غوره کوونکی زیاتوي. هر پیغام بیا دواړو ماډلونو ته په یو وخت کې، د هماغو تنظیماتو سره، ځي، او دوه ځوابونه یو د بل تر څنګ دي، چې A او B نښه شوي. تاسو کولی شئ یوه خوا یوازې بیا جوړه کړئ. کله چې یوه خوا tool وغواړي، هغه پایله چې تاسو یې لیږئ یوازې همدې خوا ته دوام ورکوي.

د شریکولو لینک کاپي کړئ ګفتګه پخپله لینک کې ډکوي، د # وروسته په برخه کې. هیڅ نه پورته کیږي. انځورونه، ستاسو کیلي او د وروستي چلولو جزئیات وتل کیږي. هر څوک چې لینک پرانیزي ګفتګه د نوې ګفتګې په توګه په خپل playground کې ترلاسه کوي.
ګفتګه چې د لینک لپاره ډیره اوږده وي د یادښت سره رد کیږي. پر ځای یې د JSON په توګه ډاونلوډ کړئ.
د ګفتګې JSON ډاونلوډ کړئ ګفتګه د خپلو تنظیماتو سره د فایل په توګه ساتي. د ګفتګو په پینل کې JSON وارد کړئ داسې فایل پرانیزي.
د cURL په توګه کاپي کړئ اوسنۍ غوښتنه د یوې cURL کمانډ په توګه کاپي کوي.

څه چیرته ساتل کیږي

څه	چیرته ساتل کیږي
ګفتګې، خوندي شوي tools، وروستي ماډلونه، د پینل ترتیب	پدې براوزر کې. دوی Shannon ته نه لیږل کیږي او تاسو سره بل وسیلې ته نه ځي.
API کیلي	د پرانیستي ټب په حافظه کې. پیسټ شوې کیلي هغه وخت ورکیږي کله چې پاڼه بیا بار شي یا ټب وتړل شي. کله چې ننوتلی یاست، کیلي هر ځل ستاسو له حساب لوستل کیږي.
د وروستي turn د stream رخدادونه، headers او غوښتنه	په پرانیستې پاڼه کې، تر هغه چې بیا بار شي.
غوښتنې	ستاسو له براوزر څخه API ته ستاسو د کیلي سره لیږل کیږي. دوی ستاسو پر بیلانس د هرې بلې API غوښتنې په څیر شمیرل کیږي.

کیبورډ

کلیدونه	څه کوي
`Enter`	پیغام ولیږئ.
`Shift` + `Enter`	نوې کرښه پیل کړئ.
`Ctrl` + `K`	د کمانډ palette پرانیزئ: endpoint یا ماډل بدل کړئ، system template وټاکئ، نوې ګفتګه پیل کړئ، streaming، tools یا پرتله کول سویچ کړئ. په Mac کې: ⌘ K.
`Esc`	هغه ځواب ودروئ چې لیکل کیږي، یا په تنګ سکرین کې پرانیستی پینل وتړئ.