Unang request sa isang OpenAI-compatible API sa Postman

Mayroon kang API key at gusto mong makita kung ano talaga ang ipinapadala bago ka magsulat ng kahit isang linya ng code. Ang Postman ay mainam para diyan: pinupuno mo ang URL, key at JSON body, pindutin ang Send, at lumalabas agad ang sagot sa ibaba. Para sa CheapTokens ang request ay POST https://api.cheaptokens.dev/v1/chat/completions na may Authorization: Bearer key at JSON body na naglalaman ng pangalan ng modelo.

Ang mga hakbang sa ibaba ay sumusunod sa sariling docs ng Postman (v12, ang pinakabagong bersyon sa docs site, sinuri noong 31 Oktubre 2026). Kung mas gusto mo ang terminal, ang parehong request ay nasa Your first API request with CheapTokens.

I-set up sa apat na hakbang#

Kailangan mo lang ng ilang bagay: ang base URL, ang iyong key, isang model id at isang mensahe. Iniimbak ng Postman ang unang dalawa sa mga variable, kaya hindi kailanman naipapasok ang key sa request mismo.

Ilang detalye para sa bawat hakbang.

Gumawa ng request. I-click ang Add icon sa kaliwang sidebar at piliin ang HTTP. Ang method dropdown ay default sa GET, kaya palitan ito sa POST at ilagay ang URL. Ang mga variable ng Postman ay isinusulat na {{variable_name}}; ginagamit ng docs ang {{base_url}} bilang halimbawa. Tukuyin ang base_url bilang https://api.cheaptokens.dev/v1 at ang URL field ay magiging {{base_url}}/chat/completions. Iniimbak ng Postman ang mga variable bilang string, na ayos lang dito.

Idagdag ang key. Buksan ang Authorization tab, piliin ang Bearer Token sa Auth Type dropdown at ilagay ang {{api_key}} sa Token field. Ipinapadala ito ng Postman bilang Authorization header sa Bearer format. Inirerekomenda ng docs ang eksaktong ito: itago ang token sa isang variable at tukuyin ito sa pangalan. Kung bakit mahalaga ang gawi na ito ay nasa Store an API key safely.

Isulat ang body. Sa Body tab piliin ang raw, pagkatapos ang JSON sa dropdown. Para sa raw bodies, awtomatikong itinatakda ng Postman ang katumbas na Content-Type, kaya hindi mo na kailangang idagdag ang header na iyon. I-paste ito:

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

Ang model id ay ang buong gateway_id mula sa CheapTokens docs; hindi tinatanggap ang maikling pangalan tulad ng deepseek-flash. Nililimitahan ng max_tokens ang haba ng sagot, kaya hindi tatagal ang unang pagsubok. Isa pang detalye ng Postman: ang // at /* */ comments sa isang JSON body ay tinatanggal bago ipadala, kaya maaari mong lagyan ng anotasyon ang body para sa kasamahan.

Pindutin ang Send at basahin ang tugon#

Kung tama ang lahat, ang response pane ay magpapakita ng JSON object sa OpenAI Chat Completions format. Dalawang lugar ang mahalaga:

• Ang choices[0].message.content ay ang teksto ng sagot.
• Ang usage ay naglalaman ng prompt_tokens (ang ipinadala mo) at completion_tokens (ang isinulat ng modelo). Ito ang binabayaran mo, kaya tingnan ito sa pinakaunang request.

Tingnan din ang choices[0].finish_reason. Ang stop ay nangangahulugang natapos ng modelo nang kusa; ang length ay nangangahulugang naabot ng sagot ang max_tokens at naputol. Kung makita mo iyon, taasan ang limit o basahin ang AI answer cut off? Fix finish_reason "length".

Subukan bago mo buksan ang sagot:

Magkano ang unang request#

Sabihin nating ang request sa itaas ay gumagamit ng mga 30 input token at ang sagot ay tumatagal ng mga 100 output token (halimbawa, hindi sukat; ang iyong usage field ang nagpapakita ng tunay na numero). Sa DeepSeek-V4-Flash iyon ay $0.00001 sa kasalukuyang presyo, at pareho ang presyo sa anumang oras. Ang mga presyo kada 1M token ay nasa live na talahanayan sa the pricing page.

Ang parehong Postman request ay maaaring sumubok ng ibang modelo. Palitan lamang ang model linya, halimbawa ng zai-org/GLM-5.3-Flash (390K context, hanggang 8,192 output token), at pindutin muli ang Send. Isang balanse ang sumasaklaw sa lahat ng modelo, kaya walang ibang nagbabago: parehong URL, parehong key.

Kung hindi gumana#

Ipinapakita ng Postman ang status code sa tabi ng tugon. Ito ang mga karaniwang dahilan:

Dalawang bagay na partikular sa Postman ang dapat suriin. Kung makakuha ka ng 401 o mukhang mali ang URL, tiyakin na ang base_url at api_key ay natukoy sa environment na napili mo. At kung mukhang tama ang key pero nakakakuha ka pa rin ng 401, buksan muli ang Authorization tab: dapat Bearer Token ang Auth Type, hindi No Auth. Higit pa tungkol sa mga code na ito: API 401 or 404 error. Hindi sigurado kung aling id ang gagamitin? Ang List models with GET /v1/models ay ibinabalik silang lahat.

Kapag masaya ka na, pindutin ang Save, bigyan ng pangalan ang request at pumili ng collection. Sa susunod, i-edit mo lang ang content field, o ang model linya para ihambing ang mga sagot. Ang buong API reference ay nasa the CheapTokens docs.