Fò lọ sí àkóónú
API ibi isereile

API ibi isereile

Ibanisọrọ

Gbìyànjú gbogbo model àti endpoint nínú browser pẹ̀lú key tìrẹ — output streaming, request inspector, àti code tí a ṣẹ̀dá tí o lè paste tààrà sínú app rẹ.

Ṣí Playground

Playground jẹ́ console chat fún API ní /docs/playground. O ń bá model sọ̀rọ̀, playground sì ń fi àwọn ìbéèrè kan náà ránṣẹ́ bí code rẹ ṣe máa fi wọ́n ránṣẹ́: sí ọ̀kan nínú àwọn endpoint mẹ́ta, pẹ̀lú model, system prompt, àwọn parameter àti àwọn tool tí o ṣètò. A lè ka ìbéèrè kọ̀ọ̀kan padà bí code àti bí àwọn event stream aláìṣàtúnṣe.

Bẹ̀rẹ̀

  • Fún un ní key — Nígbà tí o bá wọlé, playground ń lo API key account rẹ, ó sì ń fi balance rẹ hàn. Tí o kò bá wọlé, yan Add key kí o sì lẹ̀ key: a ń pa á mọ́ nínú tab yìí nìkan, a kì í sì í fi pamọ́ láéláé.
  • Yan endpoint àti model — Pẹpẹ òkè ní switch endpoint àti model picker. Ìjíròrò tuntun ń bẹ̀rẹ̀ lórí Chat Completions pẹ̀lú shannon-3.
  • Fi ìfiránṣẹ́ ránṣẹ́ — Tẹ̀ sísàlẹ̀ kí o sì tẹ Enter. Èsì kọ̀ọ̀kan ń darapọ̀ mọ́ ìjíròrò, nítorí náà ìfiránṣẹ́ tó kàn ń tẹ̀síwájú rẹ̀. Ojú òfo náà ń fúnni ní prompt ìbẹ̀rẹ̀ mẹ́ta àti àpẹẹrẹ ìpè tool tó ti ṣetán.

O ń rí key rẹ, o sì ń pààrọ̀ rẹ̀ ní ojú-ìwé Àwọn key àti ìlò. Àwọn key àti ìlò

Àwọn endpoint àti àwọn model

Switch endpoint ló ń pinnu ọ̀nà ìbéèrè tí playground ń kọ́. O lè yí i padà láàrín ìjíròrò; àwọn ìfiránṣẹ́ ń dúró.

Endpoint Ìbéèrè tó ń fi ránṣẹ́ Ìtọ́kasí
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic kika

Model picker ń ṣàkójọ ohun tí GET /v1/models dá padà. A lè wá nǹkan nínú rẹ̀, ó ń pa àwọn model àìpẹ́ yìí rẹ mọ́ ní òkè, ó sì ń fi iye owó fún token 1M, context window àti àwọn àmì fún tool, input àwòrán, ìrònú àti structured output hàn fún model kọ̀ọ̀kan.

Ìjíròrò náà

  • Àwọn èsì ń ṣàn sínú thread bí a ṣe ń kọ wọ́n. A ń fi ìrònú model hàn nínú block tirẹ̀ tí o lè pa dé.
  • Lábẹ́ èsì kọ̀ọ̀kan: àkókò dé token àkọ́kọ́, token ní ìṣẹ́jú-àáyá kan, àkókò tó ti kọjá, àwọn token input àti output pẹ̀lú apá cache àti ìrònú, ìṣirò owó ìyípo, ìdí ìparí àti id èsì.
  • A lè ṣàtúnṣe ìfiránṣẹ́ rẹ kí a sì tún fi ránṣẹ́ láti ibẹ̀. A lè tún ṣẹ̀dá èsì. A lè pa ìfiránṣẹ́ rẹ́, a sì lè dá ìparẹ́ náà padà fún ìṣẹ́jú-àáyá díẹ̀.
  • Stop tàbí bọtìnì Esc ń parí èsì tí a ń kọ.
  • A ń so àwọn àwòrán mọ́ pẹ̀lú bọtìnì àwòrán, nípa lílẹ̀ tàbí nípa sísọ fáìlì sílẹ̀, fún àwọn model tó ń gba àwòrán. A ń yí ìwọ̀n àwòrán sí pixel 1,568 ní ẹ̀gbẹ́ gígùn rẹ̀ kí a tó fi ránṣẹ́. A ń fo fáìlì tó ju 30 MB lọ.
  • Composer àti system prompt ń fi iye token hàn. Fún àwọn model open-weight tí a gbàlejò, ó jẹ́ ìkà pàtó láti POST /v1/tokenize. Fún àwọn model mìíràn, ìṣirò ni, tí a sàmì sí pẹ̀lú ≈.
  • Ìbéèrè tó kùnà ń fi ohun tí a ó ṣe tẹ̀lé e hàn: ṣètò key nígbà tí a kọ key, fi kún un nígbà tí balance bá tán, ìṣẹ́jú-àáyá láti dúró lẹ́yìn ìbéèrè púpọ̀ jù, tàbí ìgbìyànjú mìíràn lẹ́yìn àṣìṣe server.

Àwọn ètò ìbéèrè

Bọtìnì Settings ń ṣí panel pẹ̀lú tab mẹ́fà. Àwọn ètò jẹ́ ti ìjíròrò: ìjíròrò kọ̀ọ̀kan ń pa tirẹ̀ mọ́.

Tab Ohun tó gbé mú
System System prompt ti ìjíròrò, tí a ń fi ránṣẹ́ pẹ̀lú ìbéèrè kọ̀ọ̀kan. Template márùn-ún ń kún un, a sì ń fi iye token rẹ̀ hàn.
Parameters Max output tokens, temperature, top_p, Ipa ìrònú, àwọn stop sequence, seed, àti àwọn switch fún streaming àti ìwá orí wẹ́ẹ̀bù. Control tí endpoint tí a yàn kò ní field fún ni a pa, a sì sàmì sí.
Tools Àwọn ìtumọ̀ tool tí a fi ránṣẹ́ pẹ̀lú ìbéèrè: àwọn preset mẹ́rin (get_weather, read_file, run_shell, web_search) tàbí ìtumọ̀ tìrẹ bí JSON, àti tool_choice (auto, none, required tàbí tool kan nípasẹ̀ orúkọ). Nígbà tí model bá pe tool, thread ń fi ìpè náà hàn pẹ̀lú àpótí fún abajade. Pẹ̀lú Offer sample results tí a tan, ìtẹ̀ kan ń kún abajade àpẹẹrẹ. O tún lè tẹ tìrẹ, lẹ́yìn náà fi ránṣẹ́ láti tẹ̀síwájú ìyípo náà.
Structured response_format: text, json_object tàbí json_schema pẹ̀lú orúkọ schema àti JSON schema. Pẹ̀lú schema tí a ṣètò, a ń ṣàyẹ̀wò ìdáhùn tó gbẹ̀yìn lòdì sí i, a sì sàmì sí i nínú thread bóyá ó bá a mu tàbí kò bá a mu. A pa tab náà lórí endpoint Messages, a kò sì fi àṣàyàn tí model tí a yàn kò gbà hàn.
Code Ìbéèrè ìjíròrò lọ́wọ́lọ́wọ́ bí code cURL, Python, Node tàbí Go, tí a kọ́ láti inú ìjíròrò àti àwọn ètò rẹ̀. A ń tẹ̀ key jáde bí YOUR_API_KEY. A lè daakọ code náà tàbí ṣí i ní ojú ńlá.
Events Ìyípo tó gbẹ̀yìn bí ó ṣe rìn lórí nẹ́tíwọ́ọ̀kì: gbogbo event stream pẹ̀lú ìyàtọ̀ àkókò rẹ̀ àti filter, èsì tí a kó pọ̀, àwọn header èsì (x-request-id, content-type, retry-after, date) àti body ìbéèrè. A ń pa wọ́n mọ́ títí ojú-ìwé yóò fi tún gbé.

Àwọn ìṣàyẹ̀wò input

A ń ṣàyẹ̀wò àwọn iye tí o tẹ̀ kí a tó fi ìbéèrè ránṣẹ́. A ń sàmì iye tó wà lẹ́yìn ìwọ̀n ní field rẹ̀, a sì dá fífiránṣẹ́ dúró títí a ó fi tún un ṣe.

Ètò Ìṣàyẹ̀wò
Max output tokens Nọ́ńbà odidi láti 1 dé max_output_tokens ti model.
Temperature Nọ́ńbà láti 0 dé 2. Òfo ń fi field náà sílẹ̀ kúrò nínú ìbéèrè.
top_p Nọ́ńbà láti 0 dé 1. Òfo ń fi field náà sílẹ̀ kúrò nínú ìbéèrè.
seed Nọ́ńbà odidi.
Àwọn stop sequence 4 ni púpọ̀ jù, tí a yà sọ́tọ̀ pẹ̀lú àmì ìdádúró.
response_format Gbọdọ̀ jẹ́ èyí tí model tí a yàn ń gbà. Ìjíròrò tí a gbé lọ sí model láìsí json_schema tàbí láìsí response_format ni a dá dúró pẹ̀lú ìdí rẹ̀.
Àwọn àwòrán A yọ wọ́n kúrò nínú ìfiránṣẹ́ nígbà tí o bá yí padà sí model tó ń gba ọ̀rọ̀ nìkan, pẹ̀lú àkíyèsí.

Fi àwọn model méjì wé ara wọn

Compare two models nínú àkójọ More ń fi model picker kejì kún. Ìfiránṣẹ́ kọ̀ọ̀kan á lọ sí àwọn model méjèèjì ní àkókò kan náà, pẹ̀lú àwọn ètò kan náà, àwọn ìdáhùn méjèèjì sì dúró lẹ́gbẹ̀ẹ́ ara wọn, tí a sàmì A àti B. O lè tún ṣẹ̀dá ẹ̀gbẹ́ kan nìkan. Nígbà tí ẹ̀gbẹ́ kan bá pe tool, abajade tí o fi ránṣẹ́ ń tẹ̀síwájú ẹ̀gbẹ́ yẹn nìkan.

Pín, ṣe export àti import

  • Copy share link ń kó ìjíròrò sínú ọ̀nà asopọ̀ fúnra rẹ̀, ní apá lẹ́yìn #. A kò gbé nǹkankan sókè. A fi àwọn àwòrán, key rẹ àti àwọn ẹ̀kúnrẹ́rẹ́ ìgbéléṣẹ̀ tó gbẹ̀yìn sílẹ̀. Ẹnikẹ́ni tó bá ṣí ọ̀nà asopọ̀ náà ń gba ìjíròrò náà bí tuntun nínú playground tirẹ̀.
  • Ìjíròrò tó gùn jù fún ọ̀nà asopọ̀ ni a ń kọ̀ pẹ̀lú àkíyèsí. Download rẹ̀ bí JSON dípò.
  • Download conversation JSON ń fi ìjíròrò pẹ̀lú àwọn ètò rẹ̀ pamọ́ bí fáìlì. Import JSON nínú panel àwọn ìjíròrò ń ṣí fáìlì bẹ́ẹ̀.
  • Copy as cURL ń daakọ ìbéèrè lọ́wọ́lọ́wọ́ bí command cURL kan.

Ohun tí a pamọ́ sí ibo

Kí ni Ibi tí a ti pa á mọ́
Àwọn ìjíròrò, àwọn tool tí a fipamọ́, àwọn model àìpẹ́ yìí, ìṣètò panel Nínú browser yìí. A kò fi wọ́n ránṣẹ́ sí Shannon, wọn kì í sì í tẹ̀lé ọ lọ sí ẹ̀rọ mìíràn.
API key Nínú ìrántí tab tó ṣí. Key tí a lẹ̀ máa lọ nígbà tí ojú-ìwé bá tún gbé tàbí tab bá tì. Nígbà tí o bá wọlé, a ń ka key láti account rẹ ní ìgbà kọ̀ọ̀kan.
Àwọn event stream, header àti ìbéèrè ìyípo tó gbẹ̀yìn Nínú ojú-ìwé tó ṣí, títí yóò fi tún gbé.
Àwọn ìbéèrè A ń fi wọ́n ránṣẹ́ láti browser rẹ sí API pẹ̀lú key rẹ. A ń kà wọ́n sí balance rẹ bí ìbéèrè API mìíràn.

Keyboard

Àwọn bọtìnì Ohun tó ń ṣe
Enter Fi ìfiránṣẹ́ ránṣẹ́.
Shift + Enter Bẹ̀rẹ̀ ìlà tuntun.
Ctrl + K Ṣí command palette: yí endpoint tàbí model padà, ṣètò system template, bẹ̀rẹ̀ ìjíròrò tuntun, tan tàbí pa streaming, tool tàbí compare. Lórí Mac: ⌘ K.
Esc Dá èsì tí a ń kọ dúró, tàbí ti panel tó ṣí lórí ojú tó há.

Ṣí Playground