Unang request sa CheapTokens sa Hoppscotch: key sa isang environment

Maaari mong gawin ang iyong unang CheapTokens request sa Hoppscotch nang walang iniinstall o isinusulat na code: buksan ang web app, ilagay ang base URL at ang iyong key sa isang environment, gumawa ng isang POST /chat/completions request, pindutin ang Send. Lumalabas ang sagot at ang token counts sa response panel.

Ang tanging bagay na dapat gawin nang maingat ay ang key. Kung i-paste mo ito nang direkta sa request, mapupunta ito sa bawat screenshot at bawat shared link. Ang environment variable ay nagpapanatili nito sa isang lugar.

Sinusundan ng gabay na ito ang opisyal na Hoppscotch docs (sinuri noong 9 Nobyembre 2026; walang version o petsa ang mga pahina). Ang API side ay ang CheapTokens base URL https://api.cheaptokens.dev/v1, na gumagamit ng OpenAI Chat Completions format. Higit pa sa pareho sa CheapTokens docs.

Ilagay ang base URL at ang key sa isang environment#

May Environments icon ang Hoppscotch sa sidebar. I-click ito, gumawa ng bagong environment, pangalanan itong cheaptokens, at magdagdag ng dalawang variable:

Bakit dalawang type? Ayon sa Hoppscotch docs, ang Regular variable ay nakikita ng lahat ng makakakita ng environment, habang ang Secret ay naka-mask, hindi kailanman nisi-sync o nishare, at hindi kasama sa exports at duplicates. Ang key ay nabibilang sa pangalawang uri: ilagay ito bilang value ng variable. Pagkatapos, piliin ang cheaptokens environment para makita ito ng request.

Sa mga request, ang variable ay isinusulat bilang <<name>>: <<baseURL>> at <<api_key>>. Iyon na ang buong trick.

Buuin ang request#

REST ang aktibong mode kapag binuksan mo ang Hoppscotch. Tatlong bagay ang dapat itakda.

Method at URL. Piliin ang POST sa dropdown at ilagay:

<<baseURL>>/chat/completions

Ang key. May Bearer type ang Authorization tab ng Hoppscotch at idinadagdag ang token sa request bilang Bearer <token>. Hindi sinasabi ng docs kung gumagana ang <<api_key>> sa loob ng token field na iyon, kaya gamitin ang siguradong paraan: buksan ang Headers tab at magdagdag ng isang header.

Authorization: Bearer <<api_key>>

Wala kang manu-manong pinapalitan na variable, at hindi kailanman lumalabas ang tunay na key sa request na nakikita mo sa screen.

Ang body. Buksan ang Body tab, piliin ang application/json sa Content Type dropdown (inililista ito ng docs bilang type para sa content sa JSON format), at i-paste:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    {"role": "user", "content": "Explain what a token is in one sentence."}
  ],
  "max_tokens": 200
}

Gamitin ang buong id deepseek-ai/DeepSeek-V4-Flash-0731. Hindi tatanggapin ng API ang maikling pangalan mula sa price list. Ang DeepSeek-V4-Flash ay may 380K context at hanggang 32,768 output tokens bawat sagot, kaya ang 200 ay sadyang maliit na cap para sa test. Gusto ng ibang model? Palitan ang field na iyon ng zai-org/GLM-5.3-Flash (390K context, hanggang 8,192 output tokens) at mag-send muli.

Pindutin ang Send at basahin ang sagot#

I-click ang Send. Ipinapakita ng response section ang status code, body, headers, cookies at timing. Gusto mo ang 200 at isang JSON body na hugis OpenAI chat completion format. Dalawang lugar ang mahalaga:

• Ang choices[0].message.content ay ang sagot ng model.
• Ang usage ay may prompt_tokens (ang ipinadala mo) at completion_tokens (ang isinulat ng model). Iyon ang binabayaran mo, kaya dito mo sinusuri kung ang isang request ay nagkakahalaga ng inaasahan mo.

Tingnan din ang choices[0].finish_reason. Ang stop ay nangangahulugang natapos ang model nang kusa. Ang length ay nangangahulugang pinutol ng iyong max_tokens ang sagot. Kung nakita mo iyon sa isang tanong na isang pangungusap, masyadong mababa ang cap. May mas mahabang paliwanag sa AI answer cut off? Fix finish_reason "length".

I-save ang request sa isang collection at magagamit muli ito: palitan ang mensahe, pindutin muli ang Send.

Magkano ang isang test request#

Kumuha ng maikling tanong at maikling sagot: sabihin nating 30 tokens in at 150 out. Ang isang ganoong request ay nagkakahalaga ng $0.000015, at ang live table sa ibaba ay nagbibilang ng 100 sa kanila kasama ang input at output, katabi ng OpenRouter.

Sa kabuuan, kasama ang input at output, mas mura iyon kaysa OpenRouter para sa parehong model. Mag-iiba ang sarili mong numero, kaya i-drag ang mga slider sa sarili mong kaso:

Ang mga presyo ay fixed per model, walang peak-hour pricing, at isang balance ang sumasaklaw sa lahat ng model. Ang kasalukuyang rates ay nasa pricing page.

Kung hindi gumana#

Karamihan ng first-request failure sa REST client ay nagmumula sa tatlong field. Itugma ang sintomas sa sanhi:

Para sa unang dalawa may buong walk-through sa API 401 or 404 error: wrong key, base URL or model id. Kung hindi ka sigurado kung aling id ang gagamitin, list models with GET /v1/models.

Saan pupunta susunod#

Gumagana ang parehong request sa ibang client: tingnan ang Postman version o ang VS Code .http file. Kung mas gusto mong ilayo ang mga key sa mga file at shell, sinasaklaw ng store an API key safely ang mga basic. Ang mga model id at ang OpenAI-compatible endpoint ay inilalarawan sa docs.