API প্লেগ্রাউন্ড

ইন্টারঅ্যাক্টিভ

ব্রাউজারে আপনার নিজের key দিয়ে প্রতিটি মডেল ও এন্ডপয়েন্ট চেষ্টা করুন — স্ট্রিমিং আউটপুট, রিকোয়েস্ট ইন্সপেক্টর এবং সরাসরি আপনার অ্যাপে পেস্ট করার মতো জেনারেট করা কোড।

প্লেগ্রাউন্ড চালু করুন

প্লেগ্রাউন্ড হলো /docs/playground-এ API-র জন্য একটি চ্যাট কনসোল। আপনি একটি মডেলের সাথে কথা বলেন, আর প্লেগ্রাউন্ড ঠিক সেই রিকোয়েস্টই পাঠায় যা আপনার কোড পাঠাত: তিনটি এন্ডপয়েন্টের একটিতে, আপনার ঠিক করা মডেল, সিস্টেম প্রম্পট, প্যারামিটার ও টুলসহ। প্রতিটি রিকোয়েস্ট কোড হিসেবে এবং কাঁচা স্ট্রিম ইভেন্ট হিসেবে আবার পড়া যায়।

শুরু করুন

একটি key দিন — সাইন ইন করা থাকলে প্লেগ্রাউন্ড আপনার অ্যাকাউন্টের API key ব্যবহার করে এবং আপনার ব্যালেন্স দেখায়। সাইন ইন না থাকলে Add key বেছে একটি key পেস্ট করুন: এটি শুধু এই ট্যাবে থাকে এবং কখনো সেভ হয় না।
একটি এন্ডপয়েন্ট ও একটি মডেল বাছুন — ওপরের বারে এন্ডপয়েন্ট সুইচ ও মডেল পিকার আছে। নতুন কথোপকথন শুরু হয় Chat Completions-এ shannon-3 দিয়ে।
একটি মেসেজ পাঠান — নিচে টাইপ করে Enter চাপুন। প্রতিটি উত্তর কথোপকথনে যুক্ত হয়, তাই পরের মেসেজ তা এগিয়ে নেয়। খালি স্ক্রিনে তিনটি শুরুর প্রম্পট এবং একটি তৈরি টুল-কল উদাহরণ থাকে।

আপনার key Keys & usage পেজে পাবেন এবং বদলাতে পারবেন। Keys & usage

এন্ডপয়েন্ট ও মডেল

এন্ডপয়েন্ট সুইচ ঠিক করে প্লেগ্রাউন্ড কোন রিকোয়েস্ট ফরম্যাট তৈরি করবে। কথোপকথনের মাঝখানেও এটি বদলানো যায়; মেসেজগুলো থেকে যায়।

এন্ডপয়েন্ট	যে রিকোয়েস্ট পাঠায়	রেফারেন্স
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic

মডেল পিকার GET /v1/models যা ফেরত দেয় তার তালিকা দেখায়। এতে খোঁজা যায়, আপনার সাম্প্রতিক মডেলগুলো ওপরে থাকে, এবং প্রতিটি মডেলের জন্য প্রতি 1M tokens-এর দাম, কনটেক্সট উইন্ডো এবং টুল, ইমেজ ইনপুট, রিজনিং ও স্ট্রাকচার্ড আউটপুটের চিহ্ন দেখানো হয়।

কথোপকথন

উত্তর লেখা হওয়ার সাথে সাথে থ্রেডে স্ট্রিম হয়ে আসে। মডেলের রিজনিং আলাদা একটি ব্লকে দেখানো হয়, যা আপনি ভাঁজ করতে পারেন।
প্রতিটি উত্তরের নিচে: প্রথম token পর্যন্ত সময়, প্রতি সেকেন্ডে tokens, অতিবাহিত সময়, ক্যাশড ও রিজনিং অংশসহ ইনপুট ও আউটপুট tokens, টার্নের খরচের আনুমানিক হিসাব, ফিনিশ রিজন এবং রেসপন্স id।
আপনার একটি মেসেজ সম্পাদনা করে সেই বিন্দু থেকে আবার পাঠানো যায়। একটি উত্তর পুনরায় তৈরি করা যায়। একটি মেসেজ মুছে ফেলা যায়, এবং মোছা কয়েক সেকেন্ড পর্যন্ত ফেরানো যায়।
Stop বা Esc কী যে উত্তর লেখা হচ্ছে তা শেষ করে দেয়।
ইমেজ নেয় এমন মডেলের জন্য ইমেজ যুক্ত করা যায় ইমেজ বোতাম দিয়ে, পেস্ট করে অথবা ফাইল ড্রপ করে। পাঠানোর আগে ইমেজের লম্বা প্রান্ত 1,568 পিক্সেলে ছোট করা হয়। 30 MB-এর বেশি ফাইল বাদ যায়।
কম্পোজার ও সিস্টেম প্রম্পট একটি token সংখ্যা দেখায়। হোস্টেড ওপেন-ওয়েট মডেলের জন্য এটি POST /v1/tokenize থেকে পাওয়া সঠিক সংখ্যা। অন্য মডেলের জন্য এটি একটি আনুমানিক সংখ্যা, ≈ দিয়ে চিহ্নিত।
ব্যর্থ রিকোয়েস্ট পরে কী করতে হবে তা দেখায়: key প্রত্যাখ্যাত হলে key সেট করুন, ব্যালেন্স শেষ হলে টপ-আপ করুন, অতিরিক্ত রিকোয়েস্টের পর কত সেকেন্ড অপেক্ষা করতে হবে, অথবা সার্ভার এররের পর পুনরায় চেষ্টা।

রিকোয়েস্ট সেটিংস

Settings বোতাম ছয়টি ট্যাবসহ একটি প্যানেল খোলে। সেটিংস কথোপকথনের অংশ: প্রতিটি কথোপকথন নিজের সেটিংস ধরে রাখে।

ট্যাব	এতে কী থাকে
সিস্টেম	কথোপকথনের সিস্টেম প্রম্পট, প্রতিটি রিকোয়েস্টের সাথে পাঠানো হয়। পাঁচটি টেমপ্লেট এটি ভরে দেয়, এবং এর token সংখ্যা দেখানো হয়।
প্যারামিটার	সর্বোচ্চ আউটপুট tokens, টেম্পারেচার, `top_p`, রিজনিং এফোর্ট, স্টপ সিকোয়েন্স, `seed`, এবং স্ট্রিমিং ও ওয়েব সার্চের সুইচ। নির্বাচিত এন্ডপয়েন্টে যে কন্ট্রোলের ফিল্ড নেই তা বন্ধ করা থাকে এবং চিহ্নিত হয়।
টুলস	রিকোয়েস্টের সাথে পাঠানো টুল সংজ্ঞা: চারটি প্রিসেট (`get_weather`, `read_file`, `run_shell`, `web_search`) অথবা JSON হিসেবে আপনার নিজের সংজ্ঞা, এবং `tool_choice` (`auto`, `none`, `required` বা নাম ধরে একটি টুল)। মডেল টুল কল করলে থ্রেডে কলটি ফলাফলের জন্য একটি বক্সসহ দেখায়। Offer sample results চালু থাকলে এক ক্লিকে নমুনা ফলাফল বসে। নিজের ফলাফলও টাইপ করে পাঠিয়ে টার্ন এগিয়ে নিতে পারেন।
স্ট্রাকচার্ড	`response_format`: `text`, `json_object`, অথবা schema-র নাম ও একটি JSON schema সহ `json_schema`। schema দেওয়া থাকলে শেষ উত্তর তার বিপরীতে যাচাই হয় এবং থ্রেডে মিলেছে বা মেলেনি বলে চিহ্নিত হয়। Messages এন্ডপয়েন্টে ট্যাবটি বন্ধ থাকে, এবং নির্বাচিত মডেল যে বিকল্প নেয় না তা দেওয়া হয় না।
কোড	বর্তমান কথোপকথনের রিকোয়েস্ট cURL, Python, Node বা Go কোড হিসেবে, কথোপকথন ও তার সেটিংস থেকে তৈরি। key ছাপা হয় `YOUR_API_KEY` হিসেবে। কোড কপি করা যায় বা বড় ভিউতে খোলা যায়।
ইভেন্ট	শেষ টার্ন যেভাবে তারের ওপর দিয়ে গেছে: সময়ের ব্যবধান ও ফিল্টারসহ প্রতিটি স্ট্রিম ইভেন্ট, জোড়া লাগানো উত্তর, উত্তরের হেডার (`x-request-id`, `content-type`, `retry-after`, `date`) এবং রিকোয়েস্ট বডি। এগুলো পেজ রিলোড না হওয়া পর্যন্ত থাকে।

ইনপুট যাচাই

আপনি যে মান টাইপ করেন তা রিকোয়েস্ট পাঠানোর আগে যাচাই হয়। সীমার বাইরের মান তার ফিল্ডে চিহ্নিত হয় এবং ঠিক না হওয়া পর্যন্ত পাঠানো আটকে থাকে।

সেটিং	যাচাই
সর্বোচ্চ আউটপুট tokens	1 থেকে মডেলের `max_output_tokens` পর্যন্ত একটি পূর্ণসংখ্যা।
টেম্পারেচার	0 থেকে 2 পর্যন্ত একটি সংখ্যা। খালি রাখলে ফিল্ডটি রিকোয়েস্টে যায় না।
`top_p`	0 থেকে 1 পর্যন্ত একটি সংখ্যা। খালি রাখলে ফিল্ডটি রিকোয়েস্টে যায় না।
`seed`	একটি পূর্ণসংখ্যা।
স্টপ সিকোয়েন্স	সর্বোচ্চ 4টি, কমা দিয়ে আলাদা করা।
`response_format`	নির্বাচিত মডেল যা নেয় তার একটি হতে হবে। `json_schema` বা `response_format` নেই এমন মডেলে সরানো কথোপকথন কারণ জানিয়ে আটকে রাখা হয়।
ইমেজ	শুধু টেক্সট নেয় এমন মডেলে গেলে একটি নোটসহ মেসেজ থেকে সরিয়ে ফেলা হয়।

দুটি মডেলের তুলনা

More মেনুর Compare two models একটি দ্বিতীয় মডেল পিকার যোগ করে। তখন প্রতিটি মেসেজ একই সেটিংসে একই সময়ে দুটি মডেলেই যায়, এবং দুটি উত্তর A ও B চিহ্নিত হয়ে পাশাপাশি থাকে। আপনি এক পাশ আলাদাভাবে পুনরায় তৈরি করতে পারেন। এক পাশ টুল কল করলে আপনার পাঠানো ফলাফল শুধু সেই পাশকেই এগিয়ে নেয়।

Copy share link কথোপকথনকে লিঙ্কের ভেতরেই, #-এর পরের অংশে, প্যাক করে। কিছু আপলোড হয় না। ইমেজ, আপনার key এবং শেষ রানের বিবরণ বাদ থাকে। যে লিঙ্কটি খোলে সে কথোপকথনটি নিজের প্লেগ্রাউন্ডে নতুন কথোপকথন হিসেবে পায়।
লিঙ্কের জন্য অতি দীর্ঘ কথোপকথন একটি নোটসহ প্রত্যাখ্যাত হয়। তার বদলে JSON হিসেবে ডাউনলোড করুন।
Download conversation JSON কথোপকথনটি সেটিংসসহ একটি ফাইল হিসেবে সেভ করে। কথোপকথন প্যানেলের Import JSON এমন ফাইল খোলে।
Copy as cURL বর্তমান রিকোয়েস্টটি একটি cURL কমান্ড হিসেবে কপি করে।

কী কোথায় রাখা হয়

কী	কোথায় রাখা হয়
কথোপকথন, সেভ করা টুল, সাম্প্রতিক মডেল, প্যানেল লেআউট	এই ব্রাউজারে। এগুলো Shannon-এ পাঠানো হয় না এবং অন্য ডিভাইসে আপনার সাথে যায় না।
API key	খোলা ট্যাবের মেমরিতে। পেস্ট করা key পেজ রিলোড বা ট্যাব বন্ধ করলে চলে যায়। সাইন ইন থাকলে key প্রতিবার আপনার অ্যাকাউন্ট থেকে পড়া হয়।
শেষ টার্নের স্ট্রিম ইভেন্ট, হেডার ও রিকোয়েস্ট	খোলা পেজে, রিলোড না হওয়া পর্যন্ত।
রিকোয়েস্ট	আপনার ব্রাউজার থেকে আপনার key দিয়ে API-তে পাঠানো হয়। অন্য যেকোনো API রিকোয়েস্টের মতো এগুলো আপনার ব্যালেন্স থেকে গোনা হয়।

কীবোর্ড

কী	এটি কী করে
`Enter`	মেসেজ পাঠান।
`Shift` + `Enter`	নতুন লাইন শুরু করুন।
`Ctrl` + `K`	কমান্ড প্যালেট খুলুন: এন্ডপয়েন্ট বা মডেল বদলান, সিস্টেম টেমপ্লেট বসান, নতুন কথোপকথন শুরু করুন, স্ট্রিমিং, টুল বা তুলনা চালু-বন্ধ করুন। Mac-এ: ⌘ K।
`Esc`	যে উত্তর লেখা হচ্ছে তা থামান, অথবা সরু স্ক্রিনে খোলা প্যানেল বন্ধ করুন।