Panduan Pengguna API DeepSeek V4

1. Pendaftaran & Otentikasi

API DeepSeek V4 kompatibel dengan SDK OpenAI, yang secara signifikan mengurangi biaya migrasi dan memungkinkan pengembang untuk berintegrasi secara mulus dengan alat ekosistem AI yang ada.

Mendapatkan Kunci API

1. Kunjungi Platform DeepSeek.
2. Klik "API Keys" -> "Create new secret key" di sudut kanan atas.
3. Catatan: Kunci hanya ditampilkan sekali saat pembuatan, jadi simpanlah dengan aman.

2. Mulai Cepat (Contoh Python)

Pertama, instal SDK OpenAI resmi (ya, Anda tidak salah baca, gunakan saja SDK OpenAI):

pip install openai

Kemudian, cukup ubah dua parameter: base_url dan api_key.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # Kunci API DeepSeek Anda
    base_url="https://api.deepseek.com"  # Poin kunci!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # Nama model, mungkin berbeda setelah rilis V4
    messages=[
        {"role": "system", "content": "Anda adalah asisten AI yang membantu."},
        {"role": "user", "content": "Halo, tolong perkenalkan DeepSeek V4."},
    ],
    stream=False
)

print(response.choices[0].message.content)

3. Fitur Lanjutan

3.1 Keluaran Streaming

Untuk meningkatkan pengalaman pengguna, disarankan untuk mengaktifkan keluaran streaming, yang memungkinkan pengguna melihat efek pembuatan seperti mesin tik.

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Tulis puisi panjang tentang paus"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 Pemanggilan Fungsi (Function Calling)

DeepSeek V4 mendukung Function Calling yang kuat, yang mampu mem-parsing parameter JSON dengan tepat, menjadikannya ideal untuk membangun Agen.

3.3 Mode JSON

Jika Anda membutuhkan model untuk mengeluarkan format JSON yang valid, pastikan untuk menentukan json_object di response_format dan secara eksplisit meminta keluaran JSON di prompt.

4. Harga & Pengoptimalan Biaya

Harga DeepSeek V4 sangat terjangkau (harga spesifik menunggu pengumuman resmi, referensi V3 seharga $0,14/M token). Untuk lebih menghemat uang:

• Prompt Caching: V4 memperkenalkan mekanisme caching konteks. Jika System Prompt Anda panjang (misalnya, basis pengetahuan), permintaan selanjutnya akan memakan biaya yang jauh lebih sedikit karena hit cache.
• Rampingkan Konteks: Jangan menjejalkan riwayat obrolan yang tidak relevan ke dalamnya.

5. Praktik Terbaik

• Penanganan Kesalahan: Pastikan untuk menerapkan try-except, terutama untuk kesalahan rate_limit_exceeded (429), dengan strategi percobaan ulang backoff eksponensial.
• Pengaturan Batas Waktu: Tugas penalaran yang kompleks mungkin memerlukan waktu pembuatan yang lebih lama, jadi atur batas waktu ke 60 detik atau lebih.
• System Prompt: Beri V4 "persona" yang jelas dan kinerjanya akan lebih baik.

Mengalami masalah? Periksa Dokumentasi API kami atau bergabunglah dengan komunitas Discord untuk mendapatkan bantuan.