API Playground
ԻնտերակտիվՓորձեք յուրաքանչյուր մոդել և endpoint բրաուզերում՝ ձեր սեփական բանալիով. streaming արդյունք, հարցման ստուգիչ և գեներացված կոդ, որը կարելի է անմիջապես տեղադրել ձեր հավելվածում։
Playground-ը API-ի չատ-կոնսոլ է /docs/playground հասցեում։ Դուք խոսում եք մոդելի հետ, և playground-ը ուղարկում է նույն հարցումները, ինչ կուղարկեր ձեր կոդը՝ երեք endpoint-ներից մեկին, ձեր սահմանած մոդելով, system prompt-ով, պարամետրերով և գործիքներով։ Յուրաքանչյուր հարցում կարելի է հետ կարդալ որպես կոդ և որպես հոսքի հում իրադարձություններ։
Սկսել
- Տվեք բանալի — Մուտք գործած լինելու դեպքում playground-ն օգտագործում է ձեր հաշվի API բանալին և ցույց է տալիս ձեր մնացորդը։ Առանց մուտքի ընտրեք Ավելացնել բանալի և տեղադրեք բանալին. այն պահվում է միայն այս ներդիրում և երբեք չի պահպանվում։
- Ընտրեք endpoint և մոդել — Վերևի գոտին պարունակում է endpoint-ի անջատիչը և մոդելի ընտրիչը։ Նոր զրույցը սկսվում է Chat Completions-ով և
shannon-3-ով։ - Ուղարկեք հաղորդագրություն — Գրեք ներքևում և սեղմեք Enter։ Յուրաքանչյուր պատասխան միանում է զրույցին, ուստի հաջորդ հաղորդագրությունը շարունակում է այն։ Դատարկ էկրանը առաջարկում է երեք սկզբնական prompt և պատրաստի գործիքի կանչի օրինակ։
Ձեր բանալին կարող եք գտնել և փոխարինել «Բանալիներ և օգտագործում» էջում։ Բանալիներ և օգտագործում
Endpoint-ներ և մոդելներ
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 թոքենի համար, համատեքստի պատուհանը և նշաններ՝ գործիքների, պատկերի մուտքի, reasoning-ի և կառուցվածքային արդյունքի համար։
Զրույցը
- Պատասխանները հոսում են զրույցի մեջ՝ գրվելու ընթացքում։ Մոդելի reasoning-ը ցուցադրվում է իր առանձին բլոկում, որը կարելի է ծալել։
- Յուրաքանչյուր պատասխանի տակ՝ ժամանակը մինչև առաջին թոքենը, թոքեն վայրկյանում, անցած ժամանակը, մուտքային և ելքային թոքենները՝ cache-ված և reasoning մասերով, փուլի արժեքի գնահատականը, ավարտի պատճառը և response id-ն։
- Ձեր հաղորդագրությունը կարելի է խմբագրել և այդ կետից նորից ուղարկել։ Պատասխանը կարելի է վերագեներացնել։ Հաղորդագրությունը կարելի է ջնջել, և ջնջումը կարելի է հետարկել մի քանի վայրկյան։
- Stop-ը կամ Esc ստեղնն ավարտում է գրվող պատասխանը։
- Պատկերները կցվում են պատկերի կոճակով, տեղադրելով կամ ֆայլ քաշելով, պատկեր ընդունող մոդելների համար։ Պատկերը ուղարկելուց առաջ մասշտաբավորվում է մինչև 1,568 պիքսել՝ երկար կողմով։ 30 MB-ից մեծ ֆայլը բաց է թողնվում։
- Composer-ը և system prompt-ը ցույց են տալիս թոքենների քանակ։ Hosted open-weight մոդելների համար դա
POST /v1/tokenize-ի ճշգրիտ քանակն է։ Մյուս մոդելների համար դա գնահատական է՝ նշված≈-ով։ - Ձախողված հարցումը ցույց է տալիս, թե ինչ անել հետո՝ սահմանել բանալի, երբ այն մերժվել է, լրացնել, երբ մնացորդը սպառվել է, ցույց է տալիս սպասելու վայրկյանները շատ հարցումներից հետո, կամ կրկնություն՝ սերվերի սխալից հետո։
Հարցման կարգավորումներ
Կարգավորումներ կոճակը բացում է վեց ներդիրով վահանակ։ Կարգավորումները պատկանում են զրույցին. յուրաքանչյուր զրույց պահում է իրենը։
| Ներդիր | Ինչ է պարունակում |
|---|---|
| System | Զրույցի system prompt-ը, որն ուղարկվում է յուրաքանչյուր հարցմամբ։ Այն լրացնում են հինգ կաղապար, և ցույց է տրվում նրա թոքենների քանակը։ |
| Պարամետրեր | Ելքի առավելագույն թոքեններ, temperature, top_p, reasoning effort, կանգի հաջորդականություններ, seed և անջատիչները streaming-ի ու վեբ որոնման համար։ Կառավարիչը, որի համար ընտրված endpoint-ը դաշտ չունի, անջատված է և նշված։ |
| Գործիքներ | Հարցմամբ ուղարկվող գործիքների սահմանումներ՝ չորս պատրաստի տարբերակ (get_weather, read_file, run_shell, web_search) կամ ձեր սեփական սահմանումը JSON-ով, և tool_choice (auto, none, required կամ մեկ գործիք՝ անունով)։ Երբ մոդելը գործիք է կանչում, զրույցը ցույց է տալիս կանչը արդյունքի համար դաշտով։ Առաջարկել օրինակային արդյունքներ միացված լինելիս մեկ սեղմումը լրացնում է օրինակային արդյունք։ Կարող եք նաև գրել ձերը, ապա ուղարկել՝ փուլը շարունակելու համար։ |
| Կառուցվածքային | response_format՝ text, json_object կամ json_schema schema-ի անունով և JSON schema-ով։ Schema-ի դեպքում վերջին պատասխանը ստուգվում է դրա դեմ և զրույցում նշվում է որպես համապատասխանող կամ ոչ։ Ներդիրն անջատված է Messages endpoint-ում, իսկ ընտրված մոդելի չընդունած տարբերակը չի առաջարկվում։ |
| Կոդ | Ընթացիկ զրույցի հարցումը որպես cURL, Python, Node կամ Go կոդ՝ կառուցված զրույցից և նրա կարգավորումներից։ Բանալին տպվում է որպես YOUR_API_KEY։ Կոդը կարելի է պատճենել կամ բացել մեծ տեսքով։ |
| Իրադարձություններ | Վերջին փուլը այնպես, ինչպես անցավ ցանցով՝ հոսքի յուրաքանչյուր իրադարձություն իր ժամանակային շեղումով և զտիչով, հավաքված պատասխանը, պատասխանի header-ները (x-request-id, content-type, retry-after, date) և հարցման մարմինը։ Դրանք պահվում են մինչև էջի վերաբեռնումը։ |
Մուտքի ստուգումներ
Ձեր մուտքագրած արժեքները ստուգվում են հարցումն ուղարկելուց առաջ։ Միջակայքից դուրս արժեքը նշվում է իր դաշտի մոտ, և ուղարկումը կասեցվում է, մինչև այն ուղղվի։
| Կարգավորում | Ստուգում |
|---|---|
| Ելքի առավելագույն թոքեններ | Ամբողջ թիվ՝ 1-ից մինչև մոդելի max_output_tokens։ |
| Temperature | Թիվ 0-ից 2։ Դատարկը դաշտը հանում է հարցումից։ |
top_p | Թիվ 0-ից 1։ Դատարկը դաշտը հանում է հարցումից։ |
seed | Ամբողջ թիվ։ |
| Կանգի հաջորդականություններ | Առավելագույնը 4՝ բաժանված ստորակետերով։ |
response_format | Պետք է լինի ընտրված մոդելի ընդունածներից մեկը։ json_schema կամ response_format չունեցող մոդելին տեղափոխված զրույցը կասեցվում է՝ պատճառը նշելով։ |
| Պատկերներ | Հանվում են հաղորդագրությունից, երբ անցնում եք միայն տեքստ ընդունող մոդելի, նշումով։ |
Համեմատել երկու մոդել
Համեմատել երկու մոդել «Ավելին» ցանկում ավելացնում է երկրորդ մոդելի ընտրիչ։ Այդ դեպքում յուրաքանչյուր հաղորդագրություն միաժամանակ գնում է երկու մոդելներին՝ նույն կարգավորումներով, և երկու պատասխանները կանգնում են կողք կողքի՝ նշված A և B։ Կարող եք վերագեներացնել մեկ կողմը առանձին։ Երբ մի կողմը կանչում է գործիք, ձեր ուղարկած արդյունքը շարունակում է միայն այդ կողմը։
Կիսվել, արտահանել և ներմուծել
- Պատճենել կիսվելու հղումը զրույցը փաթեթավորում է հենց հղման մեջ՝
#-ից հետո մասում։ Ոչինչ չի վերբեռնվում։ Պատկերները, ձեր բանալին և վերջին գործարկման մանրամասները դուրս են թողնվում։ Հղումը բացողը ստանում է զրույցը որպես նոր զրույց իր սեփական playground-ում։ - Հղման համար չափազանց երկար զրույցը մերժվում է նշումով։ Փոխարենը ներբեռնեք այն որպես JSON։
- Ներբեռնել զրույցի JSON-ը պահում է զրույցը՝ իր կարգավորումներով, որպես ֆայլ։ Ներմուծել JSON զրույցների վահանակում բացում է այդպիսի ֆայլ։
- Պատճենել որպես cURL պատճենում է ընթացիկ հարցումը որպես մեկ cURL հրաման։
Ինչ որտեղ է պահվում
| Ինչ | Որտեղ է պահվում |
|---|---|
| Զրույցներ, պահված գործիքներ, վերջին մոդելներ, վահանակի դասավորություն | Այս բրաուզերում։ Դրանք չեն ուղարկվում Shannon-ին և չեն հետևում ձեզ մեկ այլ սարք։ |
| API բանալի | Բաց ներդիրի հիշողության մեջ։ Տեղադրված բանալին վերանում է էջը վերաբեռնելիս կամ ներդիրը փակելիս։ Մուտք գործած լինելիս բանալին ամեն անգամ կարդացվում է ձեր հաշվից։ |
| Վերջին փուլի հոսքի իրադարձությունները, header-ները և հարցումը | Բաց էջում՝ մինչև վերաբեռնումը։ |
| Հարցումներ | Ուղարկվում են ձեր բրաուզերից API-ին՝ ձեր բանալիով։ Դրանք հաշվվում են ձեր մնացորդից, ինչպես ցանկացած այլ API հարցում։ |
Ստեղնաշար
| Ստեղներ | Ինչ է անում |
|---|---|
Enter | Ուղարկել հաղորդագրությունը։ |
Shift + Enter | Սկսել նոր տող։ |
Ctrl + K | Բացել հրամանների palette-ը՝ փոխել endpoint-ը կամ մոդելը, սահմանել system կաղապար, սկսել նոր զրույց, միացնել streaming-ը, գործիքները կամ համեմատումը։ Mac-ում՝ ⌘ K։ |
Esc | Կանգնեցնել գրվող պատասխանը, կամ փակել բաց վահանակը նեղ էկրանի վրա։ |