DeepSeek API key: ano ang i-paste saan, at isang unang tawag

Ang DeepSeek API key ay isang lihim na string na nagsasabi sa API kung sino ang nagpapadala ng request. Gayunpaman, hindi kailanman kailangan ng isang tool ang key nang mag-isa: kailangan nito ang tatlong value nang sabay — ang key, ang base URL at ang model id. Itakda ang tatlong iyon at gagana ang unang tawag.

Malamang hinanap mo ito dahil may form na nagtatanong sa iyo ng "iyong DeepSeek API key": isang script, isang editor plugin, isang n8n node. Sige. Tingnan natin kung ano ang hinihingi ng bawat field, at pagkatapos ay magpadala ng isang tunay na request.

Ano ba talaga ang API key?#

Isipin mo ang isang hotel key card. Hindi nito sinasabi sa salita kung sino ka; binubuksan lang nito ang iyong pinto at sisingilin ng front desk ang iyong kwarto. Ganoon din ang ginagawa ng API key: nakikita ito ng server sa request, alam nito kung aling account ang sisingilin, at pinapayagan ang tawag. Mawala ang card at kahit sino ay makakapasok at sisingilin ang iyong kwarto — kaya ang key ay inilalayo sa code at sa mga chat. (Ang mas mahabang kuwento ay nasa What is an API key and how to store it safely.)

Ang sariling API docs ng DeepSeek (sinuri noong 4 Nobyembre 2026) ay nagpapakita ng parehong ugali: ang key ay inilalagay sa isang environment variable, DEEPSEEK_API_KEY, bago mo patakbuhin ang anumang halimbawa, at ang API ay sumusunod sa format ng OpenAI — gumagana ang OpenAI SDK kapag binago mo ang api_key at base_url. Iyon ang buong trick, at iyon ang dahilan kung bakit hindi kailanman naglalakbay nang mag-isa ang isang key.

Isang detalye na nakakalito sa mga tao: ang isang key ay pag-aari ng serbisyong nag-isyu nito. Ang CheapTokens key ay kasama ng address ng CheapTokens, at ang model id ay ang nakalista ng CheapTokens. Paghaluin ang key mula sa isang lugar at ang address ng iba at makakakuha ka ng authorization error, hindi sagot.

Ilagay ang key sa isang environment variable#

Gumawa ng key sa iyong CheapTokens account (ang mga hakbang ay nasa docs) at panatilihing may laman ang balanse para may mahugot ang request. Pagkatapos, itago ang key sa isang variable sa halip na i-paste ito sa isang file.

macOS o Linux:

export CHEAPTOKENS_API_KEY='paste-your-key-here'

Windows PowerShell (kasalukuyang window lang):

$env:CHEAPTOKENS_API_KEY = 'paste-your-key-here'

Ang bahaging paste-your-key-here ay isang placeholder; ilagay ang iyong tunay na key doon sa iyong sariling terminal at wala nang iba. Bakit ito mas mabuti kaysa sa hard-coded na key, at ano ang gagawin kung may tumagas, ay nasa Store an API key safely: env variable, .gitignore, leak fix.

Ang unang request#

Sabihin nating gusto mo lang makita itong gumagana: hilingin sa modelo na ipaliwanag ang isang API key sa isang pangungusap. Parehong request, dalawang paraan — piliin ang tab na ginagamit mo.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain an API key in one sentence."}],
    "max_tokens": 200
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CHEAPTOKENS_API_KEY'],
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain an API key in one sentence.'}],
    max_tokens=200,
)

print(resp.choices[0].message.content)
print(resp.usage)

Ang bersyon ng Python ay nangangailangan ng pip install openai nang isang beses. Tingnan kung ano ang nagbago kumpara sa isang script na isinulat para sa OpenAI SDK: api_key, base_url at model — ang parehong tatlong value. Ang lahat ng iba ay nananatiling tulad ng dati.

Ano ang dapat mong makita#

Ang tugon ay JSON. Ang teksto ng sagot ay nasa choices[0].message.content; iyon ang unang ipinapakita ng Python script. Sa tabi mismo nito ay may usage block na may prompt_tokens, completion_tokens at total_tokens — kung ilang token ang pumasok, ilan ang lumabas, at ang kabuuan. Ang gastos ay kinakalkula mula sa dalawang numerong ito, kaya sulit silang tingnan kahit sa unang tawag (Input vs output tokens ang nagpapaliwanag ng paghahati).

Para magkaroon ng ideya sa sukat: ang isang tawag na tulad nito ay napakaliit. Kunin ang 30 token na pumapasok at 200 na lumalabas — ang max_tokens na kisame mula sa halimbawa, kaya ang pinakamahal na tawag na magagawa ng request na ito. Nagkakahalaga ito ng $0.00002. Isang libo sa mga ito ay ganito ang hitsura, kasama ang OpenRouter sa tabi para sa sanggunian:

Ang modelong nasa likod ng id na iyon ay DeepSeek-V4-Flash: isang 380K-token na context window at hanggang 32,768 token sa isang sagot. Pareho ang presyo sa anumang oras, walang peak-time surcharge, at isang balanse ang sumasaklaw sa bawat modelo. Sa kabuuan — input at output na magkasama — mas mura ito kaysa sa OpenRouter, na eksaktong ipinapakita ng talahanayan sa itaas. Higit pa tungkol sa modelo: DeepSeek on CheapTokens, kasalukuyang presyo sa pricing page.

Kapag hindi ito gumana#

Halos lahat ng pagkabigo sa unang tawag ay isa sa tatlong value ang mali. Itugma ang sintomas sa salarin:

Ang buong walkthrough ng mga error na ito ay nasa API 401 or 404 error: wrong key, base URL or model id. At kung hindi ka sigurado kung anong id ang gagamitin, tanungin ang API mismo: List models with GET /v1/models.

Saan pupunta ang parehong tatlong value sa susunod#

Ang punto ng pag-aaral ng mga ito nang isang beses ay portable sila. Halos anumang tool na nakikipag-usap sa isang OpenAI-compatible API ay humihingi ng parehong mga value na ito sa ilang anyo: ang key, ang address at ang modelo. Sa isang script (LangChain, LiteLLM) sila ay mga argumento; sa isang app o no-code node sila ay mga field o setting. Maaari mo ring subukan ang mga ito nang walang code sa Postman. Para sa streaming at mahahabang sagot gamit ang modelong ito, magpatuloy sa DeepSeek-V4-Flash quickstart.