Kunci API DeepSeek: apa yang ditempel di mana, dan panggilan pertama

Kunci API DeepSeek adalah string rahasia yang memberi tahu API siapa yang mengirim permintaan. Namun, sebuah alat tidak pernah hanya membutuhkan kunci itu saja: ia membutuhkan tiga nilai sekaligus — kunci, base URL, dan id model. Set ketiganya dan panggilan pertama akan berhasil.

Anda mungkin mencari ini karena suatu formulir meminta "kunci API DeepSeek Anda": sebuah skrip, plugin editor, node n8n. Baiklah. Mari kita lihat apa yang diminta setiap kolom, lalu kirim satu permintaan sungguhan.

Apa itu kunci API, sebenarnya?#

Bayangkan kartu kunci hotel. Kartu itu tidak menyebutkan siapa Anda dengan kata-kata; ia hanya membuka pintu Anda dan resepsionis menagih ke kamar Anda. Kunci API melakukan hal yang sama: server melihatnya dalam permintaan, tahu akun mana yang harus ditagih, dan meloloskan panggilan tersebut. Kehilangan kartu berarti siapa pun bisa masuk dan menagih kamar Anda — jadi kunci disimpan di luar kode dan di luar obrolan. (Cerita lengkapnya ada di Apa itu kunci API dan cara menyimpannya dengan aman.)

Dokumentasi API DeepSeek sendiri (diperiksa 4 November 2026) menunjukkan kebiasaan yang sama: kunci dimasukkan ke variabel lingkungan, DEEPSEEK_API_KEY, sebelum Anda menjalankan contoh apa pun, dan API mengikuti format OpenAI — SDK OpenAI berfungsi setelah Anda mengubah api_key dan base_url. Itulah seluruh triknya, dan itulah sebabnya kunci tidak pernah berjalan sendiri.

Satu detail yang sering membuat orang tersandung: kunci milik layanan yang menerbitkannya. Kunci CheapTokens cocok dengan alamat CheapTokens, dan id model adalah yang terdaftar di CheapTokens. Campurkan kunci dari satu tempat dengan alamat dari tempat lain dan Anda akan mendapat kesalahan otorisasi, bukan jawaban.

Letakkan kunci di variabel lingkungan#

Buat kunci di akun CheapTokens Anda (langkah-langkahnya ada di dokumentasi) dan jaga saldo tetap terisi agar permintaan memiliki sumber dana. Lalu simpan kunci di variabel alih-alih menempelkannya ke file.

macOS atau Linux:

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

Windows PowerShell (hanya jendela saat ini):

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

Bagian paste-your-key-here adalah placeholder; letakkan kunci asli Anda di sana di terminal Anda sendiri dan di tempat lain tidak. Mengapa ini lebih baik daripada kunci yang di-hard-code, dan apa yang harus dilakukan jika kunci bocor, ada di Simpan kunci API dengan aman: variabel env, .gitignore, perbaikan kebocoran.

Permintaan pertama#

Katakanlah Anda hanya ingin melihatnya bekerja: minta model menjelaskan kunci API dalam satu kalimat. Permintaan yang sama, dua cara — pilih tab yang Anda gunakan.

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)

Versi Python membutuhkan pip install openai sekali. Perhatikan apa yang berubah dibandingkan dengan skrip yang ditulis untuk SDK OpenAI: api_key, base_url dan model — tiga nilai yang sama. Sisanya tetap seperti semula.

Apa yang seharusnya Anda lihat#

Balasannya adalah JSON. Teks jawaban ada di choices[0].message.content; itulah yang pertama dicetak skrip Python. Tepat di sebelahnya ada blok usage dengan prompt_tokens, completion_tokens dan total_tokens — berapa banyak token yang masuk, berapa yang keluar, dan jumlahnya. Biaya dihitung dari kedua angka ini, itulah sebabnya keduanya layak dilihat sekilas bahkan pada panggilan pertama (Token input vs output menjelaskan pembagiannya).

Untuk merasakan skalanya: panggilan seperti ini sangat kecil. Ambil 30 token masuk dan 200 keluar — batas max_tokens dari contoh, jadi panggilan paling mahal yang bisa dilakukan permintaan ini. Biayanya $0.00002. Seribu panggilan seperti ini terlihat seperti berikut, dengan OpenRouter di sampingnya sebagai referensi:

Model di balik id itu adalah DeepSeek-V4-Flash: jendela konteks 380K token dan hingga 32.768 token dalam satu jawaban. Harganya sama pada jam berapa pun, tanpa biaya tambahan jam sibuk, dan satu saldo mencakup semua model. Secara total — input dan output bersama — hasilnya lebih murah daripada OpenRouter, yang persis ditunjukkan tabel di atas. Lebih lanjut tentang model: DeepSeek di CheapTokens, harga terkini di halaman harga.

Ketika tidak berhasil#

Hampir setiap kegagalan panggilan pertama adalah salah satu dari tiga nilai yang salah. Cocokkan gejala dengan penyebabnya:

Panduan lengkap kesalahan ini ada di Kesalahan API 401 atau 404: kunci, base URL, atau id model yang salah. Dan jika Anda tidak yakin id mana yang harus digunakan, tanyakan pada API itu sendiri: Daftar model dengan GET /v1/models.

Ke mana tiga nilai yang sama pergi selanjutnya#

Inti dari mempelajarinya sekali adalah bahwa nilainya portabel. Hampir semua alat yang berkomunikasi dengan API yang kompatibel dengan OpenAI meminta nilai yang sama dalam beberapa bentuk: kunci, alamat, dan model. Dalam skrip (LangChain, LiteLLM) nilainya adalah argumen; dalam aplikasi atau node no-code nilainya adalah kolom atau pengaturan. Anda juga dapat mencobanya tanpa menulis kode di Postman. Untuk streaming dan jawaban panjang dengan model ini, lanjutkan dengan panduan cepat DeepSeek-V4-Flash.