ናብ ትሕዝቶ ዝለል
API Playground

API Playground

ኢንተራክቲቭ

ነፍሲ ወከፍ ሞዴልን endpointን ኣብ browser ብናይ ርእስኻ ቁልፊ ፈትን — streaming ውጽኢት፣ request inspector ከምኡውን ብቐጥታ ናብ app ዝትእቱዎ ዝተፈጥረ ኮድ።

Playground ጀምር

playground ኣብ /docs/playground ንAPI ናይ ዕላል console እዩ። ምስ ሓደ ሞዴል ትዛረብ፣ playground ድማ ኮድካ ዝልእኾ ተመሳሳሊ ጠለባት ይልእክ፦ ናብ ሓደ ካብ ሰለስተ endpoints፣ ምስ ዘዘጋጀካዮ ሞዴል፣ system prompt፣ parameters ከምኡውን tools። ነፍሲ ወከፍ ጠለብ ከም ኮድን ከም raw stream events ን ክንበብ ይከኣል።

ጀምር

  • ቁልፊ ሃቦ — ምስ ኣተኻ፣ playground API key ናይ ኣካውንትካ ይጥቀም ከምኡውን ሚዛንካ የርኢ። ዘይኣተኻ እንተ ኾይኑ Add key ምረጽ እሞ ቁልፊ ለጥፍ፦ ኣብዚ tab ጥራይ ይቕመጥ ከምኡውን ፈጺሙ ኣይዕቀብን።
  • endpoint ከምኡውን ሞዴል ምረጽ — እቲ ላዕለዋይ ባር switch ናይ endpoint ከምኡውን መራጺ ሞዴል ይሕዝ። ሓድሽ ዕላል ኣብ Chat Completions ምስ shannon-3 ይጅምር።
  • መልእኽቲ ልኣኽ — ኣብ ታሕቲ ጸሓፍ እሞ Enter ጠውቕ። ነፍሲ ወከፍ ምላሽ ናብ ዕላል ይውሰኽ፣ ስለዚ እቲ ዝቕጽል መልእኽቲ የቐጽሎ። እቲ ባዶ ማያ ሰለስተ መጀመርታ prompts ከምኡውን ድሉው ኣብነት ጥሪ tool የቕርብ።

ቁልፍካ ኣብ ገጽ 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 የርኢ።

እቲ ዕላል

  • ምላሽ ከም ዝጽሓፍ ናብ thread ይዋሕዝ። reasoning ናይ ሞዴል ኣብ ናቱ block ይርኣይ፣ ክትሓውሶ ትኽእል።
  • ኣብ ትሕቲ ነፍሲ ወከፍ ምላሽ፦ ግዜ ክሳብ ቀዳማይ token፣ tokens ኣብ ሰከንድ፣ ዝሓለፈ ግዜ፣ input ከምኡውን output tokens ምስ cached ከምኡውን reasoning ክፍልታት፣ ግምት ዋጋ እቲ turn፣ ምኽንያት መወዳእታን response id ን።
  • ናይ ባዕልኻ መልእኽቲ ክቕየር ከምኡውን ካብ ሽዑ ጀሚሩ ደጊሙ ክለኣኽ ይከኣል። ምላሽ ደጊሙ ክፍጠር ይከኣል። መልእኽቲ ክስረዝ ይከኣል፣ ስረዛ ድማ ንውሑዳት ሰከንድታት ክምለስ ይከኣል።
  • Stop ወይ እቲ Esc ቁልፊ እቲ እትጽሕፍ ዘሎ ምላሽ የቋርጽ።
  • ስእልታት ብ image button፣ ብምልጣፍ ወይ ፋይል ብምውዳቕ ንሞዴላት ስእሊ ዝቕበሉ ይተሓዙ። ሓደ ስእሊ ቅድሚ ምልኣኽ ኣብ ነዊሕ ጫፉ ናብ 1,568 pixels ይንኣስ። ልዕሊ 30 MB ዝኾነ ፋይል ይሕለፍ።
  • እቲ composer ከምኡውን system prompt ቁጽሪ tokens የርእዩ። ንhosted open-weight ሞዴላት ልክዕ ቁጽሪ ካብ POST /v1/tokenize እዩ። ንካልኦት ሞዴላት ግምት እዩ፣ ብ ≈ ዝተመልከተ።
  • ዝወደቐ ጠለብ ቀጺሉ እንታይ ክግበር ከም ዘለዎ የርኢ፦ ቁልፊ ምስ ተነጺጉ ቁልፊ ኣዘጋጅ፣ ሚዛን ምስ ወዲኡ ምላእ፣ ብዙሓት ጠለባት ምስ መጹ እቲ ንምጽባይ ሰከንድታት፣ ወይ ድሕሪ ጌጋ server ደጊም ፈትን።

Settings ናይ ጠለብ

እቲ Settings button ሽዱሽተ tabs ዘለዎ ፓነል የፍቱ። Settings ናይ ዕላል እዮም፦ ነፍሲ ወከፍ ዕላል ናቱ ይሕዝ።

Tab እንታይ ይሕዝ
System system prompt ናይ ዕላል፣ ምስ ነፍሲ ወከፍ ጠለብ ዝልኣኽ። ሓሙሽተ templates የዕብዩዎ፣ ቁጽሪ tokens ኡ ድማ ይርኣይ።
Parameters እቲ ዝለዓለ ብዝሒ ናይ output tokens፣ temperature፣ top_p፣ ደረጃ ናይ reasoning (effort)፣ ናይ ምቁም ተኸታታሊታት (stop sequences)፣ seed፣ ከምኡውን ምልውዋጢ ን streaming ከምኡውን web search። እቲ ዝተመርጸ endpoint field ዘይብሉ control ይጠፍእ ከምኡውን ይምለክት።
Tools ምስ ጠለብ ዝልእኽ ትርጉማት tool፦ ኣርባዕተ presets (get_weather፣ read_file፣ run_shell፣ web_search) ወይ ናትካ ትርጉም ከም JSON፣ ከምኡውን tool_choice (auto፣ none፣ required ወይ ሓደ tool ብስሙ)። እቲ ሞዴል tool ምስ ዝጽውዕ፣ thread እቲ ጥሪ ምስ ሳጹን ን ውጽኢት የርኢ። Offer sample results ምስ ዝበራ፣ ሓደ ጠውቕ ናሙና ውጽኢት የምልእ። ናትካ ውን ክትጽሕፍ ደሓር ክትልእኽ ትኽእል፣ እቲ turn ንምቕጻል።
Structured response_format፦ text፣ json_object ወይ json_schema ምስ ስም schema ከምኡውን JSON schema። schema ምስ ዝዘጋጅእ፣ እቲ ናይ መወዳእታ መልሲ ንዕኡ ይምርመር ከምኡውን ኣብ thread ከም ዝሰማማዕ ወይ ዘይሰማማዕ ይምለክት። እዚ tab ኣብ Messages endpoint ይጠፍእ፣ እቲ ዝተመርጸ ሞዴል ዘይቅበሎ ኣማራጺ ድማ ኣይቐርብን።
ኮድ እቲ ጠለብ ናይ ሕጂ ዕላል ከም cURL፣ Python፣ Node ወይ Go ኮድ፣ ካብ ዕላልን settings ኡን ዝተሃንጸ። ቁልፊ ከም YOUR_API_KEY ይሕተም። እቲ ኮድ ክቕዳሕ ወይ ኣብ ዓቢ ርእይቶ ክኽፈት ይከኣል።
Events እቲ ናይ መወዳእታ turn ከም ኣብ መስመር ዝሓለፈ፦ ነፍሲ ወከፍ stream event ምስ time offset ከምኡውን ፊልተር፣ እቲ ዝተኣከበ ምላሽ፣ headers ናይ ምላሽ (x-request-id፣ content-type፣ retry-after፣ date) ከምኡውን body ናይ ጠለብ። እዞም ክሳብ ገጽ ዝጽዓን ይቕመጡ።

ምርመራ ኣተዋብ

ዝጸሓፍካዮም ዋጋታት ቅድሚ ጠለብ ምልኣኽ ይምርመሩ። ካብ ወሰን ዝወጽእ ዋጋ ኣብ field ኡ ይምለክት፣ ምልኣኽ ድማ ክሳብ ዝስተኻኸል ይተሓዝ።

Setting መርመራ
Max output tokens ካብ 1 ክሳብ max_output_tokens ናይቲ ሞዴል ዘሎ ምሉእ ቁጽሪ።
Temperature ካብ 0 ክሳብ 2 ዘሎ ቁጽሪ። ባዶ እንተ ኮይኑ እቲ field ካብ ጠለብ ይወጽእ።
top_p ካብ 0 ክሳብ 1 ዘሎ ቁጽሪ። ባዶ እንተ ኮይኑ እቲ field ካብ ጠለብ ይወጽእ።
seed ምሉእ ቁጽሪ።
Stop sequences ዝለዓለ 4፣ ብነጠብጣብ ዝተፈልዩ።
response_format እቲ ዝተመርጸ ሞዴል ዝቕበሎ ዓይነት ክኸውን ኣለዎ። ናብ json_schema ዘይብሉ ወይ response_format ዘይብሉ ሞዴል ዝተሰጋገረ ዕላል ምስ ምኽንያቱ ይተሓዝ።
ስእልታት ናብ ጽሑፍ ጥራይ ዝቕበል ሞዴል ምስ ትሰጋገር፣ ምስ መልእኽቲ ካብቲ መልእኽቲ ይእለዩ።

ክልተ ሞዴላት የነጻጽሩ

ክልተ ሞዴላት የነጻጽሩ ኣብ More menu ካልኣይ መራጺ ሞዴል ይውስኽ። ነፍሲ ወከፍ መልእኽቲ ብሓደ ግዜ ናብ ክልቲኦም ሞዴላት፣ ምስ ሓደ settings፣ ይኸይድ፣ እቶም ክልተ መልስታት ጎኒ ንጎኒ፣ ብ A ከምኡውን B ተመልኪቶም ይቐመጡ። ሓደ ወገን ጥራይ ደጊምካ ክትፈጥሮ ትኽእል። ሓደ ወገን tool ምስ ዝጽውዕ፣ እቲ ትልእኾ ውጽኢት ነቲ ወገን ጥራይ የቐጽሎ።

ምክፋል፣ ምውጻእን ምእታውን

  • Copy share link እቲ ዕላል ኣብ ባዕሉ link፣ ኣብታ ድሕሪ # ዘላ ክፍሊ የእሱሮ። ዝኾነ ነገር ኣይጽዓንን። ስእልታት፣ ቁልፍካ ከምኡውን ዝርዝር እቲ ናይ መወዳእታ ሩጫ ይወጹ። እቲ link ዝኸፍት ዝኾነ ሰብ እቲ ዕላል ከም ሓድሽ ኣብ playground ናቱ ይረክብ።
  • ንlink ዝነውሐ ዕላል ምስ መልእኽቲ ይኣወግድ። ከም JSON ኣውርዶ።
  • Download conversation JSON እቲ ዕላል ምስ settings ኡ ከም ፋይል የቐምጦ። ኣብ ፓነል ዕላላት Import JSON ከምዚ ዝኣመሰለ ፋይል የፍቱ።
  • Copy as cURL እቲ ሕጂ ዘሎ ጠለብ ከም ሓደ cURL command ይቅዳሕ።

እንታይ ኣበይ ይዕቀብ

እንታይ ኣበይ ይዕቀብ
ዕላላት፣ ዝተዐቀቡ tools፣ ቀረባ ሞዴላት፣ ቅርጺ ፓነል ኣብዚ browser። ናብ Shannon ኣይልኣኹን ከምኡውን ናብ ካልእ መሳርሒ ኣይስዕቡኻን።
API key ኣብ memory ናይ ዝተኸፍተ tab። ዝተለጠፈ ቁልፊ ገጽ ምስ ዝጽዓን ወይ tab ምስ ዝዕጾ ይጠፍእ። ምስ ኣተኻ፣ ቁልፊ ነፍሲ ወከፍ ግዜ ካብ ኣካውንትካ ይንበብ።
Stream events፣ headers ከምኡውን ጠለብ ናይ መወዳእታ turn ኣብ ዝተኸፍተ ገጽ፣ ክሳብ ዝጽዓን።
ጠለባት ካብ browser ናትካ ምስ ቁልፍካ ናብ API ይለኣኹ። ከም ካልእ ዝኾነ ናይ API ጠለብ ኣብ ሚዛንካ ይቑጸሩ።

ከይቦርድ

ቁልፍታት እንታይ ይገብር
Enter እቲ መልእኽቲ ልኣኽ።
Shift + Enter ሓድሽ መስመር ጀምር።
Ctrl + K command palette ክፈት፦ endpoint ወይ ሞዴል ቀይር፣ system template ኣዘጋጅ፣ ሓድሽ ዕላል ጀምር፣ streaming፣ tools ወይ ምንጽጻር ቀይር። ኣብ Mac፦ ⌘ K።
Esc እቲ እትጽሕፍ ዘሎ ምላሽ ኣቋርጽ፣ ወይ ኣብ ጸቢብ ማያ ዝተኸፍተ ፓነል ዕጸው።

Playground ጀምር