API 401 o 404 error: maling key, base URL o model id

Nabigo ang iyong request na may status code at hindi ka sigurado kung ano ang unang aayusin. Maikling sagot: ang 401 ay karaniwang tumutukoy sa key, ang 404 ay karaniwang nangangahulugang kumakatok ka sa maling lugar — alinman sa address (base URL at path) o ang model id. Tatlong bagay ang dapat suriin, sa ganitong pagkakasunod-sunod, at isang curl command na nagpapatunay ng fix.

Ang error-codes page ng OpenAI (sinuri noong 26 Oktubre 2026) ay naglilista ng dalawang 401 na mensahe: "Invalid Authentication" at "Incorrect API key provided". Ang fix na ibinibigay nito ay pareho para sa dalawa: suriin ang key o gumawa ng bago. Ang page ay hindi nagdodokumento ng 404 para sa API mismo, kaya para sa 404 ang tuntunin sa ibaba ay nagmumula sa kung paano gumagana ang mga OpenAI-compatible endpoint, hindi mula sa page na iyon.

Ang mabilis na paraan upang makilala sila#

Ang pananalita ng mensahe ay depende sa server at sa iyong tool (Cline, Aider, OpenCode at Continue ay bawat isa ay nagbabalot ng mga error sa sarili nilang paraan), kaya magsimula sa numero, pagkatapos ay kumpirmahin gamit ang curl check sa ibaba.

401: hindi tumutugma ang key sa endpoint#

Ang klasikong kuwento: inilipat mo ang isang tool sa bagong provider, pinalitan ang base URL, at iniwan ang key ng lumang provider sa config. Bago ang address, luma ang key, at ang server ay sumasagot ng 401. Walang sira; ang key ay nabibilang lamang sa ibang bahay.

Ano ang dapat suriin:

1. Aling provider ang nag-isyu ng key? Dapat ito ang provider na tinatawagan mo ng address. Ang key para sa isang serbisyo ay hindi valid sa iba.
2. Mga stray na karakter. Isang space o line break na na-paste kasama ng key, o mga quote na napunta sa loob ng value.
3. Saan ito binabasa ng tool. Ang environment variable na nakatakda sa isang terminal at hindi sa terminal kung saan nagsimula ang iyong editor ay madalas na sanhi. Kung ang tool ay may parehong config file at environment variable, alamin kung alin ang nananaig.
4. Isang revoked o deleted na key. Ang key na iyong binura o ni-revoke ay tumitigil sa paggana — gumawa ng bago at ilagay ito sa config.

Kung hindi ka sigurado kung paano gumagana ang mga key o saan ito itatago, ano ang API key at paano ito itago nang ligtas ay sumasaklaw nito sa simpleng pananalita.

404 sa bawat model: mali ang address#

Ang base URL para sa CheapTokens ay https://api.cheaptokens.dev/v1. Ang mga tool at SDK ay nagdaragdag mismo ng endpoint path, kaya ang karaniwang pagkakamali ay tungkol sa /v1:

• Kulang na /v1: ang tool ay tumatawag sa https://api.cheaptokens.dev/chat/completions.
• Doble ang /v1: na-paste mo ang buong path sa isang field na nagdaragdag na nito, at nakakuha ng https://api.cheaptokens.dev/v1/v1/chat/completions.
• Maling flavour: ang mga OpenAI-style na tool at ang OpenAI SDK ay tumatanggap ng address na may /v1. Ang Anthropic SDK at Claude Code ay tumatanggap ng address na walang /v1: https://api.cheaptokens.dev.

Kung nagtaka ka na kung ano talaga ang base URL at aling bahagi nito ang idinadagdag ng tool, ang explainer na ito ay dumadaan dito. Para sa panig ng Anthropic, tingnan ang ang Anthropic Python SDK kasama ang CheapTokens.

404 sa isang model: ang model id#

Ang isang ito ay nakakahuli sa mga taong kumokopya ng pangalan mula sa price table o mula sa ibang provider. Ang price table ay maaaring magsabi ng DeepSeek-V4-Flash; ang API ay nangangailangan ng buong gateway id, kasama ang developer prefix at ang release:

Ang mga short id mula sa price label ay hindi tinatanggap ng API, at mahalaga ang spelling: capital letters, ang slash, ang -0731 suffix. Kopyahin ang id mula sa dokumentasyon ng CheapTokens sa halip na i-type ito mula sa memorya — iba't ibang provider ang nagpapangalan sa parehong model nang iba. Upang makita ang eksaktong mga id na available sa iyong key, tawagan ang GET https://api.cheaptokens.dev/v1/models gamit ang parehong Authorization header at kopyahin ang id mula sa listahan:

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Kung ang lohika ng pangalan sa talahanayan ay mukhang kakaiba, paano basahin ang mga pangalan ng AI model ay nagpapaliwanag ng alias kumpara sa pinned version.

Patunayan ang fix gamit ang isang curl command#

Alisin ang tool sa eksena at tawagan ang API nang direkta. Palitan ang key placeholder ng sarili mo:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hi in one word."}],
    "max_tokens": 20
  }'

Ang isang request na ito ay may lahat ng tatlong suspek: ang key sa header, ang base URL sa unang linya, ang model id sa body. Ang JSON reply na may choices array ay nangangahulugang tama ang lahat ng tatlo, at anuman ang ginagawa ng iyong tool nang iba ay ang problema. Kung nabigo ito, baguhin ang isa na bagay sa isang pagkakataon:

• 401 → palitan ng key na nakuha mo mula sa CheapTokens at patakbuhin muli.
• 404 → ihambing ang URL nang karakter sa karakter sa nasa itaas, pagkatapos ang model id.

Pagkatapos gumana ang curl, kopyahin ang parehong tatlong value sa tool: ang key, ang base URL (https://api.cheaptokens.dev/v1, o walang /v1 para sa Anthropic SDK at Claude Code) at ang buong model id.

Kung hindi pa rin ito gumagana#

• Parehong error sa tool, maayos ang curl. Ang tool ay nagbabasa ng lumang key o URL mula sa ibang lugar: isang pangalawang config file, isang saved profile, isang environment variable. I-restart ang tool pagkatapos baguhin ito.
• Hindi sigurado kung tama ang model id. Tawagan ang GET /v1/models gamit ang iyong key at kopyahin ang id mula sa listahan.
• Connection refused, timeouts, certificate errors. Hindi iyon 401 o 404; tingnan ang mga karaniwang connection error.
• Hindi sigurado kung ano ang dapat hitsura ng unang request. Ang iyong unang API request ay dumadaan nang hakbang-hakbang, at ang mga docs ay may buong reference.

Ang ugali na dapat panatilihin: kapag nabigo ang isang call, basahin muna ang numero. Ang 401 ay karaniwang nangangahulugang ang key, ang 404 ay karaniwang ang address o model id, at ang curl ang nag-aayos nito. Naayos nito ang karamihan sa mga error na ito bago ka pa magbukas ng kahit isang log.