API Playground
ተግባራዊእያንዳንዱን ሞዴል እና endpoint በራስዎ ቁልፍ በአሳሹ ውስጥ ይሞክሩ — streaming ውጤት፣ የጥያቄ መርማሪ፣ እና በቀጥታ ወደ መተግበሪያዎ መለጠፍ የሚችሉት የተፈጠረ ኮድ።
Playground በ/docs/playground ላይ ለAPI የchat console ነው። ከሞዴል ጋር ይነጋገራሉ፣ እና playground ኮድዎ የሚልከውን ተመሳሳይ ጥያቄዎች ይልካል፦ ከሦስቱ endpoints ወደ አንዱ፣ ባዘጋጁት ሞዴል፣ system prompt፣ መለኪያዎች እና tools። እያንዳንዱ ጥያቄ እንደ ኮድ እና እንደ ጥሬ stream events ተመልሶ ሊነበብ ይችላል።
መጀመር
- ቁልፍ ይስጡት — ከገቡ playground የመለያዎን API ቁልፍ ይጠቀማል እና ቀሪ ሂሳብዎን ያሳያል። ካልገቡ Add key ን ይምረጡና ቁልፍ ይለጥፉ፦ በዚህ tab ውስጥ ብቻ ይቆያል እና በፍጹም አይቀመጥም።
- endpoint እና ሞዴል ይምረጡ — የላይኛው አሞሌ የendpoint መቀየሪያውን እና የሞዴል መምረጫውን ይይዛል። አዲስ ውይይት በChat Completions እና በ
shannon-3ይጀምራል። - መልእክት ይላኩ — ከታች ይጻፉና Enter ይጫኑ። እያንዳንዱ ምላሽ በውይይቱ ውስጥ ይካተታል፣ ስለዚህ የሚቀጥለው መልእክት ይቀጥለዋል። ባዶው ስክሪን ሦስት የመነሻ prompts እና ዝግጁ የtool ጥሪ ምሳሌ ያቀርባል።
ቁልፍዎን በKeys & usage ገጽ ላይ ያገኛሉ እና ይቀይራሉ። Keys & usage
Endpoints እና ሞዴሎች
የendpoint መቀየሪያ playground የሚገነባውን የጥያቄ ፎርማት ይወስናል። በውይይት መሃል ሊቀይሩት ይችላሉ፤ መልእክቶቹ ይቆያሉ።
| Endpoint | የሚልከው ጥያቄ | ማጣቀሻ |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic ፎርማት |
የሞዴል መምረጫው GET /v1/models የሚመልሰውን ይዘረዝራል። ሊፈለግ ይችላል፣ የቅርብ ጊዜ ሞዴሎችዎን ከላይ ያስቀምጣል፣ እና ለእያንዳንዱ ሞዴል በ1M tokens ዋጋውን፣ context window እና ለtools፣ ለምስል ግብዓት፣ ለreasoning እና ለstructured output ምልክቶችን ያሳያል።
ውይይቱ
- ምላሾች ሲጻፉ ወደ ውይይቱ ይፈሳሉ (stream)። የሞዴሉ reasoning ሊታጠፍ በሚችል በራሱ block ውስጥ ይታያል።
- ከእያንዳንዱ ምላሽ በታች፦ እስከ መጀመሪያው token ያለው ጊዜ፣ tokens በሰከንድ፣ የቆየው ጊዜ፣ input እና output tokens ከcached እና reasoning ክፍሎች ጋር፣ የዙሩ ወጪ ግምት፣ የማጠናቀቂያ ምክንያት እና የምላሽ id።
- የእርስዎ መልእክት ሊስተካከል እና ከዚያ ነጥብ እንደገና ሊላክ ይችላል። ምላሽ እንደገና ሊመነጭ ይችላል። መልእክት ሊሰረዝ ይችላል፣ ስረዛውም ለጥቂት ሰከንዶች ሊመለስ ይችላል።
- Stop ወይም የEsc ቁልፍ እየተጻፈ ያለውን ምላሽ ያቆማል።
- ምስሎች ምስል ለሚቀበሉ ሞዴሎች በምስል አዝራሩ፣ በመለጠፍ ወይም ፋይል በመጣል ይያያዛሉ። ምስል ከመላኩ በፊት ረጅሙ ጎኑ ወደ 1,568 ፒክሰል ይቀነሳል። ከ30 MB በላይ የሆነ ፋይል ይዘለላል።
- ጸሐፊው እና system prompt የtoken ቆጠራ ያሳያሉ። ለተስተናገዱ open-weight ሞዴሎች ከ
POST /v1/tokenizeየሚገኝ ትክክለኛ ቆጠራ ነው። ለሌሎች ሞዴሎች ግምት ነው፣ በ≈ምልክት የተደረገበት። - የከሸፈ ጥያቄ ቀጥሎ ምን ማድረግ እንዳለብዎ ያሳያል፦ ቁልፉ ሲከለከል ቁልፍ ማዘጋጀት፣ ቀሪ ሂሳቡ ሲያልቅ ክሬዲት መሙላት፣ ብዙ ጥያቄዎች ከተላኩ በኋላ የሚጠበቁ ሰከንዶች፣ ወይም ከserver ስህተት በኋላ እንደገና መሞከር።
የጥያቄ ቅንብሮች
Settings አዝራር ስድስት tabs ያለው ፓነል ይከፍታል። ቅንብሮቹ የውይይቱ ናቸው፦ እያንዳንዱ ውይይት የራሱን ይይዛል።
| Tab | የሚይዘው |
|---|---|
| System | የውይይቱ system prompt፣ ከእያንዳንዱ ጥያቄ ጋር ይላካል። አምስት አብነቶች ይሞሉታል፣ እና የtoken ቆጠራው ይታያል። |
| መለኪያዎች | ከፍተኛ የውጤት tokens፣ temperature፣ top_p፣ reasoning effort፣ የማቆሚያ ቅደም ተከተሎች፣ seed፣ እና ለstreaming እና ለድር ፍለጋ መቀየሪያዎች። የተመረጠው endpoint መስክ የሌለው መቆጣጠሪያ ጠፍቶ ምልክት ይደረግበታል። |
| Tools | ከጥያቄው ጋር የሚላኩ የtool ትርጓሜዎች፦ አራት ቅድመ-ቅንብሮች (get_weather፣ read_file፣ run_shell፣ web_search) ወይም የራስዎ ትርጓሜ እንደ JSON፣ እና tool_choice (auto፣ none፣ required ወይም አንድ tool በስም)። ሞዴሉ tool ሲጠራ ውይይቱ ጥሪውን ለውጤት ሳጥን ጋር ያሳያል። Offer sample results ሲበራ አንድ ጠቅታ የናሙና ውጤት ይሞላል። የራስዎን መተየብም ይችላሉ፣ ከዚያ ዙሩን ለመቀጠል ይላኩት። |
| Structured | response_format፦ text፣ json_object ወይም json_schema ከschema ስም እና ከJSON schema ጋር። schema ሲዘጋጅ የመጨረሻው መልስ ከእሱ ጋር ይመረመራል እና በውይይቱ ውስጥ ይዛመዳል ወይም አይዛመድም ተብሎ ምልክት ይደረግበታል። ይህ tab በMessages endpoint ላይ ጠፍቷል፣ የተመረጠው ሞዴል የማይቀበለው አማራጭም አይቀርብም። |
| ኮድ | የአሁኑ ውይይት ጥያቄ እንደ cURL፣ Python፣ Node ወይም Go ኮድ፣ ከውይይቱ እና ከቅንብሮቹ የተገነባ። ቁልፉ እንደ YOUR_API_KEY ይታተማል። ኮዱ ሊቀዳ ወይም በትልቅ እይታ ሊከፈት ይችላል። |
| Events | የመጨረሻው ዙር በገመድ ላይ እንደሄደ፦ እያንዳንዱ stream event ከጊዜ ልዩነቱ እና ከማጣሪያ ጋር፣ የተሰበሰበው ምላሽ፣ የምላሽ headers (x-request-id፣ content-type፣ retry-after፣ date) እና የጥያቄው body። እነዚህ ገጹ እስኪታደስ ድረስ ይቆያሉ። |
የግብዓት ፍተሻዎች
የሚተይቧቸው እሴቶች ጥያቄ ከመላኩ በፊት ይፈተሻሉ። ከክልል ውጭ የሆነ እሴት በመስኩ ላይ ይታያል፣ እስኪስተካከልም መላክ ይያዛል።
| ቅንብር | ፍተሻ |
|---|---|
| ከፍተኛ የውጤት tokens | ከ1 እስከ የሞዴሉ max_output_tokens ያለ ሙሉ ቁጥር። |
| Temperature | ከ0 እስከ 2 ያለ ቁጥር። ባዶ ከሆነ መስኩ ከጥያቄው ይቀራል። |
top_p | ከ0 እስከ 1 ያለ ቁጥር። ባዶ ከሆነ መስኩ ከጥያቄው ይቀራል። |
seed | ሙሉ ቁጥር። |
| የማቆሚያ ቅደም ተከተሎች | ቢበዛ 4፣ በኮማ የተለዩ። |
response_format | የተመረጠው ሞዴል ከሚቀበላቸው አንዱ መሆን አለበት። json_schema ወይም response_format ወደሌለው ሞዴል የተዛወረ ውይይት ከምክንያቱ ጋር ይያዛል። |
| ምስሎች | ጽሑፍ ብቻ ወደሚቀበል ሞዴል ሲቀይሩ ከመልእክቱ ይወገዳሉ፣ ከማስታወሻ ጋር። |
ሁለት ሞዴሎችን ማወዳደር
በMore ምናሌ ውስጥ ሁለት ሞዴሎችን አወዳድር ሁለተኛ የሞዴል መምረጫ ይጨምራል። ከዚያ እያንዳንዱ መልእክት በተመሳሳይ ቅንብሮች ወደ ሁለቱም ሞዴሎች በአንድ ጊዜ ይሄዳል፣ ሁለቱ መልሶችም A እና B ተብለው ጎን ለጎን ይቆማሉ። አንዱን ጎን ብቻ እንደገና ማመንጨት ይችላሉ። አንድ ጎን tool ሲጠራ የሚልኩት ውጤት ያንን ጎን ብቻ ይቀጥላል።
ማጋራት፣ መላክ እና ማስገባት
- Copy share link ውይይቱን በራሱ link ውስጥ፣ ከ
#በኋላ ባለው ክፍል ያሸጋል። ምንም አይጫንም። ምስሎች፣ ቁልፍዎ እና የመጨረሻው ሩጫ ዝርዝሮች ይቀራሉ። link የሚከፍት ሁሉ ውይይቱን በራሱ playground ውስጥ እንደ አዲስ ያገኛል። - ለlink በጣም ረጅም የሆነ ውይይት በማስታወሻ ይከለከላል። በምትኩ እንደ JSON ያውርዱት።
- Download conversation JSON ውይይቱን ከቅንብሮቹ ጋር እንደ ፋይል ያስቀምጣል። በውይይቶች ፓነል ውስጥ Import JSON እንዲህ ያለውን ፋይል ይከፍታል።
- Copy as cURL የአሁኑን ጥያቄ እንደ አንድ cURL ትዕዛዝ ይቀዳል።
ምን የት ይቀመጣል
| ምን | የሚቀመጥበት |
|---|---|
| ውይይቶች፣ የተቀመጡ tools፣ የቅርብ ጊዜ ሞዴሎች፣ የፓነል አቀማመጥ | በዚህ ብሮውዘር ውስጥ። ወደ Shannon አይላኩም እና ወደ ሌላ መሣሪያ አይከተሉዎትም። |
| API ቁልፍ | በተከፈተው tab ማህደረ ትውስታ ውስጥ። የተለጠፈ ቁልፍ ገጹ ሲታደስ ወይም tab ሲዘጋ ይጠፋል። ከገቡ ቁልፉ በየጊዜው ከመለያዎ ይነበባል። |
| የመጨረሻው ዙር የstream events፣ headers እና ጥያቄ | በተከፈተው ገጽ ውስጥ፣ እስኪታደስ ድረስ። |
| ጥያቄዎች | ከብሮውዘርዎ ወደ API በቁልፍዎ ይላካሉ። እንደ ማንኛውም የAPI ጥያቄ ከቀሪ ሂሳብዎ ይቆጠራሉ። |
ቁልፍ ሰሌዳ
| ቁልፎች | የሚያደርገው |
|---|---|
Enter | መልእክቱን ይልካል። |
Shift + Enter | አዲስ መስመር ይጀምራል። |
Ctrl + K | የትዕዛዝ ፓሌቱን ይከፍታል፦ endpoint ወይም ሞዴል ይቀይሩ፣ የsystem አብነት ያዘጋጁ፣ አዲስ ውይይት ይጀምሩ፣ streaming፣ tools ወይም ማወዳደርን ያብሩ/ያጥፉ። በMac ላይ፦ ⌘ K። |
Esc | እየተጻፈ ያለውን ምላሽ ያቆማል፣ ወይም በጠባብ ስክሪን ላይ የተከፈተ ፓነል ይዘጋል። |