API Playground
ఇంటరాక్టివ్ప్రతి మోడల్ మరియు ఎండ్‌పాయింట్‌ను బ్రౌజర్‌లో మీ సొంత కీతో ప్రయత్నించండి — స్ట్రీమింగ్ అవుట్‌పుట్, రిక్వెస్ట్ ఇన్‌స్పెక్టర్ మరియు నేరుగా మీ యాప్‌లో పేస్ట్ చేయగల జెనరేట్ చేసిన కోడ్.
playground అనేది /docs/playground వద్ద API కోసం చాట్ కన్సోల్. మీరు మోడల్‌తో మాట్లాడతారు, మరియు playground మీ కోడ్ పంపేలాంటి రిక్వెస్ట్‌లనే పంపుతుంది: మూడు ఎండ్‌పాయింట్‌లలో ఒకదానికి, మీరు సెట్ చేసిన మోడల్, system prompt, పారామీటర్‌లు మరియు టూల్స్‌తో. ప్రతి రిక్వెస్ట్‌ను కోడ్‌గా మరియు ముడి స్ట్రీమ్ ఈవెంట్‌లుగా తిరిగి చదవవచ్చు.
ప్రారంభం
- దానికి కీని ఇవ్వండి — సైన్ ఇన్ చేసి ఉంటే, playground మీ ఖాతా API కీని ఉపయోగిస్తుంది మరియు మీ బ్యాలెన్స్‌ను చూపిస్తుంది. సైన్ ఇన్ చేయకపోతే, Add key ఎంచుకుని కీని పేస్ట్ చేయండి: అది ఈ ట్యాబ్‌లో మాత్రమే ఉంచబడుతుంది మరియు ఎప్పుడూ సేవ్ చేయబడదు.
- ఎండ్‌పాయింట్ మరియు మోడల్‌ను ఎంచుకోండి — పై బార్‌లో ఎండ్‌పాయింట్ స్విచ్ మరియు మోడల్ పికర్ ఉన్నాయి. కొత్త సంభాషణ
shannon-3తో Chat Completions లో మొదలవుతుంది. - మెసేజ్ పంపండి — కింద టైప్ చేసి Enter నొక్కండి. ప్రతి సమాధానం సంభాషణలో చేరుతుంది, కాబట్టి తదుపరి మెసేజ్ దాన్ని కొనసాగిస్తుంది. ఖాళీ స్క్రీన్ మూడు ప్రారంభ ప్రాంప్ట్‌లను మరియు సిద్ధంగా ఉన్న టూల్-కాల్ ఉదాహరణను అందిస్తుంది.
మీ కీని Keys & usage పేజీలో కనుగొనవచ్చు మరియు రొటేట్ చేయవచ్చు. Keys & usage
ఎండ్‌పాయింట్‌లు మరియు మోడల్స్
ఎండ్‌పాయింట్ స్విచ్ playground ఏ రిక్వెస్ట్ ఫార్మాట్‌ను నిర్మించాలో నిర్ణయిస్తుంది. సంభాషణ మధ్యలో కూడా దీన్ని మార్చవచ్చు; మెసేజ్‌లు అలాగే ఉంటాయి.
| ఎండ్‌పాయింట్ | ఇది పంపే రిక్వెస్ట్ | రిఫరెన్స్ |
|---|---|---|
| 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, టర్న్ ఖర్చు అంచనా, ముగింపు కారణం మరియు response id.
- మీ మెసేజ్‌ను ఎడిట్ చేసి ఆ బిందువు నుండి మళ్ళీ పంపవచ్చు. సమాధానాన్ని మళ్ళీ జెనరేట్ చేయవచ్చు. మెసేజ్‌ను తొలగించవచ్చు, మరియు తొలగింపును కొన్ని సెకన్ల పాటు రద్దు చేయవచ్చు.
- Stop లేదా Esc కీ రాస్తున్న సమాధానాన్ని ముగిస్తుంది.
- చిత్రాలను తీసుకునే మోడల్స్ కోసం, చిత్ర బటన్‌తో, పేస్ట్ చేయడం ద్వారా లేదా ఫైల్‌ను డ్రాప్ చేయడం ద్వారా జతచేయబడతాయి. చిత్రం పంపే ముందు దాని పొడవైన అంచున 1,568 పిక్సెల్‌లకు స్కేల్ చేయబడుతుంది. 30 MB కంటే పెద్ద ఫైల్ వదిలివేయబడుతుంది.
- కంపోజర్ మరియు system prompt tokens సంఖ్యను చూపిస్తాయి. హోస్ట్ చేసిన ఓపెన్-వెయిట్ మోడల్స్‌కు అది
POST /v1/tokenizeనుండి కచ్చితమైన లెక్క. ఇతర మోడల్స్‌కు అది≈తో గుర్తించిన అంచనా. - విఫలమైన రిక్వెస్ట్ తర్వాత ఏమి చేయాలో చూపిస్తుంది: కీ తిరస్కరించబడినప్పుడు కీని సెట్ చేయండి, బ్యాలెన్స్ అయిపోయినప్పుడు టాప్ అప్ చేయండి, చాలా రిక్వెస్ట్‌ల తర్వాత వేచి ఉండాల్సిన సెకన్లు, లేదా సర్వర్ ఎరర్ తర్వాత మళ్ళీ ప్రయత్నం.
రిక్వెస్ట్ సెట్టింగ్‌లు
Settings బటన్ ఆరు ట్యాబ్‌లతో ప్యానెల్‌ను తెరుస్తుంది. సెట్టింగ్‌లు సంభాషణకు చెందినవి: ప్రతి సంభాషణ తన సొంతవాటిని ఉంచుకుంటుంది.
| ట్యాబ్ | ఇందులో ఏముంది |
|---|---|
| System | సంభాషణ యొక్క system prompt, ప్రతి రిక్వెస్ట్‌తో పంపబడుతుంది. ఐదు టెంప్లేట్‌లు దాన్ని నింపుతాయి, మరియు దాని tokens సంఖ్య చూపబడుతుంది. |
| పారామీటర్‌లు | గరిష్ట అవుట్‌పుట్ tokens, temperature, top_p, రీజనింగ్ effort, stop sequences, seed, మరియు స్ట్రీమింగ్ మరియు వెబ్ శోధన స్విచ్‌లు. ఎంచుకున్న ఎండ్‌పాయింట్‌కు ఫీల్డ్ లేని కంట్రోల్ ఆఫ్ చేయబడి గుర్తించబడుతుంది. |
| Tools | రిక్వెస్ట్‌తో పంపిన టూల్ నిర్వచనాలు: నాలుగు ప్రీసెట్‌లు (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 కోడ్‌గా. కీ YOUR_API_KEY గా ముద్రించబడుతుంది. కోడ్‌ను కాపీ చేయవచ్చు లేదా పెద్ద వ్యూలో తెరవవచ్చు. |
| ఈవెంట్‌లు | చివరి టర్న్ నెట్‌వర్క్‌లో వెళ్లినట్లే: టైమ్ ఆఫ్‌సెట్ మరియు ఫిల్టర్‌తో ప్రతి స్ట్రీమ్ ఈవెంట్, సమీకరించిన సమాధానం, సమాధాన హెడర్‌లు (x-request-id, content-type, retry-after, date) మరియు రిక్వెస్ట్ బాడీ. ఇవి పేజీ రీలోడ్ అయ్యే వరకు ఉంచబడతాయి. |
ఇన్‌పుట్ తనిఖీలు
మీరు టైప్ చేసే విలువలు రిక్వెస్ట్ పంపే ముందు తనిఖీ చేయబడతాయి. పరిధి వెలుపల విలువ దాని ఫీల్డ్ వద్ద గుర్తించబడుతుంది, మరియు అది సరిదిద్దే వరకు పంపడం నిలిపివేయబడుతుంది.
| సెట్టింగ్ | తనిఖీ |
|---|---|
| గరిష్ట అవుట్‌పుట్ tokens | 1 నుండి మోడల్ max_output_tokens వరకు ఒక పూర్ణ సంఖ్య. |
| Temperature | 0 నుండి 2 వరకు ఒక సంఖ్య. ఖాళీగా ఉంచితే ఫీల్డ్ రిక్వెస్ట్‌లో చేర్చబడదు. |
top_p | 0 నుండి 1 వరకు ఒక సంఖ్య. ఖాళీగా ఉంచితే ఫీల్డ్ రిక్వెస్ట్‌లో చేర్చబడదు. |
seed | ఒక పూర్ణ సంఖ్య. |
| Stop sequences | గరిష్ఠంగా 4, కామాలతో వేరు చేసి. |
response_format | ఎంచుకున్న మోడల్ తీసుకునేదే అయి ఉండాలి. json_schema లేని లేదా response_format లేని మోడల్‌కు మార్చిన సంభాషణ కారణంతో పాటు నిలిపివేయబడుతుంది. |
| చిత్రాలు | టెక్స్ట్ మాత్రమే తీసుకునే మోడల్‌కు మారినప్పుడు, గమనికతో పాటు మెసేజ్ నుండి తొలగించబడతాయి. |
రెండు మోడల్స్‌ను పోల్చండి
More మెనూలోని Compare two models రెండవ మోడల్ పికర్‌ను జోడిస్తుంది. ప్రతి మెసేజ్ అప్పుడు అవే సెట్టింగ్‌లతో ఒకే సమయంలో రెండు మోడల్స్‌కు వెళ్తుంది, మరియు రెండు సమాధానాలు A మరియు B గా గుర్తించి పక్కపక్కన ఉంటాయి. మీరు ఒక వైపును మాత్రమే మళ్ళీ జెనరేట్ చేయవచ్చు. ఒక వైపు టూల్‌ను కాల్ చేసినప్పుడు, మీరు పంపే ఫలితం ఆ వైపునే కొనసాగిస్తుంది.
షేర్, ఎక్స్‌పోర్ట్ మరియు ఇంపోర్ట్
- Copy share link సంభాషణను లింక్‌లోనే,
#తర్వాత భాగంలో ప్యాక్ చేస్తుంది. ఏదీ అప్‌లోడ్ చేయబడదు. చిత్రాలు, మీ కీ మరియు చివరి రన్ వివరాలు చేర్చబడవు. లింక్‌ను తెరిచినవారికి సంభాషణ వారి సొంత playground లో కొత్త సంభాషణగా వస్తుంది. - లింక్‌కు చాలా పొడవైన సంభాషణ గమనికతో తిరస్కరించబడుతుంది. బదులుగా దాన్ని JSON గా డౌన్‌లోడ్ చేయండి.
- Download conversation JSON సంభాషణను దాని సెట్టింగ్‌లతో ఫైల్‌గా సేవ్ చేస్తుంది. సంభాషణల ప్యానెల్‌లోని Import JSON అలాంటి ఫైల్‌ను తెరుస్తుంది.
- Copy as cURL ప్రస్తుత రిక్వెస్ట్‌ను ఒక cURL కమాండ్‌గా కాపీ చేస్తుంది.
ఏది ఎక్కడ ఉంచబడుతుంది
| ఏమిటి | ఎక్కడ ఉంచబడుతుంది |
|---|---|
| సంభాషణలు, సేవ్ చేసిన టూల్స్, ఇటీవలి మోడల్స్, ప్యానెల్ లేఅవుట్ | ఈ బ్రౌజర్‌లో. అవి Shannon కు పంపబడవు మరియు మరో పరికరానికి మీతో రావు. |
| API కీ | తెరిచి ఉన్న ట్యాబ్ మెమరీలో. పేస్ట్ చేసిన కీ పేజీ రీలోడ్ అయినప్పుడు లేదా ట్యాబ్ మూసివేసినప్పుడు పోతుంది. సైన్ ఇన్ చేసి ఉంటే, కీ ప్రతిసారి మీ ఖాతా నుండి చదవబడుతుంది. |
| చివరి టర్న్ యొక్క స్ట్రీమ్ ఈవెంట్‌లు, హెడర్‌లు మరియు రిక్వెస్ట్ | తెరిచి ఉన్న పేజీలో, అది రీలోడ్ అయ్యే వరకు. |
| రిక్వెస్ట్‌లు | మీ బ్రౌజర్ నుండి మీ కీతో APIకి పంపబడతాయి. అవి ఇతర API రిక్వెస్ట్‌ల లాగే మీ బ్యాలెన్స్‌లో లెక్కించబడతాయి. |
కీబోర్డ్
| కీలు | ఇది ఏమి చేస్తుంది |
|---|---|
Enter | మెసేజ్‌ను పంపండి. |
Shift + Enter | కొత్త లైన్ ప్రారంభించండి. |
Ctrl + K | కమాండ్ పాలెట్‌ను తెరవండి: ఎండ్‌పాయింట్ లేదా మోడల్ మార్చండి, system టెంప్లేట్ సెట్ చేయండి, కొత్త సంభాషణ ప్రారంభించండి, స్ట్రీమింగ్, టూల్స్ లేదా పోలికను టోగుల్ చేయండి. Mac లో: ⌘ K. |
Esc | రాస్తున్న సమాధానాన్ని ఆపండి, లేదా ఇరుకైన స్క్రీన్‌పై తెరిచిన ప్యానెల్‌ను మూసివేయండి. |