Kunci API DeepSeek Tidak Berfungsi: Penyebab dan Solusi

Mulai dengan pengujian satu baris

Sebelum mengubah apa pun di aplikasi Anda, keluarkan klien dari persamaan. Satu panggilan curl memberi tahu Anda apakah kunci, URL, dan nama model berfungsi bersama. Ganti placeholder dengan nilai dari dasbor dan dokumentasi penyedia Anda.

Copycurl -i https://YOUR-PROVIDER/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'

Bendera -i mencetak baris status dan header, dan itu lebih penting daripada tubuh respons. Jika curl berhasil dan aplikasi Anda tidak, kesalahan ada di pengaturan aplikasi. Jika curl gagal juga, masalahnya adalah kunci, akun, atau endpoint.

Baca kode status terlebih dahulu

Ini adalah makna umum di seluruh penyedia bergaya OpenAI. Setiap penyedia mendokumentasikan kode pastinya sendiri, jadi periksa dokumentasi terbaru mereka untuk detailnya.

Kunci itu sendiri

Kunci adalah string panjang, dan mereka mudah rusak. Tempelkan kunci ke editor teks biasa dan cari spasi atau baris baru di akhir, tanda kutip di awal, atau baris baru yang ditambahkan oleh aplikasi obrolan. Pastikan header membaca Authorization: Bearer KEY dengan satu spasi setelah Bearer. Jika Anda mengatur kunci dalam variabel lingkungan, tampilkan panjangnya di aplikasi Anda (bukan nilainya) untuk mengonfirmasi bahwa kunci tersebut dimuat.

Dua kasus lain yang umum. Pertama, Anda membuat kunci, menutup halaman, dan menyalin versi yang tersembunyi sebagian. Sebagian besar dasbor menampilkan kunci sekali, jadi buat yang baru. Kedua, Anda menggunakan kunci dari satu layanan terhadap URL penyedia layanan lain. Kunci hanya valid untuk penyedia yang menerbitkannya.

Saldo, penagihan, dan kredit gratis

Banyak kunci API hanya berfungsi selama akun memiliki kredit. Saldo kosong dapat terlihat seperti kunci yang rusak. Buka halaman penagihan penyedia Anda dan konfirmasi Anda memiliki dana, bahwa pengisian saldo telah berhasil, dan bahwa kredit promosi apa pun belum kedaluwarsa. Top-up kripto dapat memakan waktu beberapa menit untuk muncul.

Jika Anda ingin membandingkan bagaimana layanan prabayar lain menangani ini, model kami sederhana: Anda membeli kredit, panggilan menguranginya sebesar $0,15 per 1M token input dan $0,50 per 1M token output, permintaan yang gagal atau ditolak tidak dibebankan, dan kredit tidak pernah kedaluwarsa. Anda dapat membaca saldo dengan GET /v1/balance atau dari header X-Balance-USD pada setiap respons.

URL dasar dan nama model

Penyebab paling sering di alat seperti SillyTavern, Janitor AI, dan plugin editor adalah URL dasar yang diketik sedikit salah. Kesalahan umum: hilang /v1, /v1/v1 ganda, menggunakan http bukan https, atau menempelkan jalur lengkap /chat/completions ke bidang yang sudah menambahkannya. Bidang model adalah jebakan lainnya. Itu harus cocok dengan ID model yang terdaftar oleh penyedia. Tampilkan daftar tersebut dengan GET /v1/models jika penyedia mendukungnya, atau baca dokumentasi saat ini.

Panduan penyiapan untuk alat tertentu ada di situs ini: menggunakan kunci di SillyTavern, di Janitor AI dan di VS Code.

Batas laju dan konkurensi

Semburan permintaan paralel dapat memicu 429 bahkan pada kunci yang valid. Cari header Retry-After dan kurangi laju permintaan. Contoh retry minimal di Python terlihat seperti ini:

Copyimport time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")

def ask(prompt):
    for attempt in range(4):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (attempt + 1))
    raise RuntimeError("still rate limited")

Di endpoint kami, kunci penuh memungkinkan 8 permintaan konkuren dan 300 permintaan per menit. Permintaan streaming memegang slotnya hingga streaming selesai. Kode error adalah rate_limited atau concurrency, dan kelebihan beban sementara mengembalikan 429 dengan Retry-After: 5.

Masalah jaringan dan regional

Jika curl menggantung atau terputus, masalah mungkin terjadi di antara Anda dan penyedia: proxy perusahaan, VPN, DNS, atau pemblokiran regional. Coba jaringan lain, periksa apakah proxy Anda meneruskan header Authorization, dan tingkatkan waktu tunggu klien untuk generasi panjang. Respons streaming juga dapat terpotong oleh proxy yang melakukan buffering; uji dengan stream: false untuk memisahkan kedua masalah tersebut.

Daftar periksa yang dapat Anda jalankan dalam lima menit

1. Jalankan pengujian curl dan catat kode status.
2. Buat kunci baru dan uji. Jika kunci baru berhasil, kunci lama disalin dengan salah atau dicabut.
3. Periksa saldo dan tanggal kedaluwarsa apa pun pada kredit.
4. Bandingkan URL dasar dan ID model dengan dokumentasi penyedia, karakter demi karakter.
5. Kirim satu permintaan tanpa streaming, tanpa alat, dan prompt pendek. Tambahkan fitur kembali satu per satu.
6. Periksa panggilan paralel. Jika aplikasi Anda menembakkan beberapa permintaan sekaligus, kurangi konkurensi.
7. Coba jaringan lain atau matikan VPN.
8. Lihat header respons, termasuk ID permintaan apa pun. Tim dukungan dapat menemukan panggilan Anda dari ID tersebut.

Langkah kelima menemukan sejumlah bug yang mengejutkan. Definisi alat yang sedikit tidak valid, nilai max_tokens yang sangat besar, atau tubuh permintaan di atas batas ukuran dapat mengembalikan error yang terlihat seperti masalah kunci API. Di endpoint kami, batas tubuh adalah 8 MB, dan setiap respons membawa header X-Request-Id yang dapat Anda kutip untuk dukungan.

Siapkan endpoint cadangan

Pemadaman dan batas terjadi dengan penyedia mana pun, jadi simpan endpoint kedua yang kompatibel dengan OpenAI di konfigurasi Anda. Endpoint kami adalah model bobot terbuka yang di-hosting dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan API resmi DeepSeek dan ini bukan router, jadi harapkan jawaban dan perilaku yang berbeda. Beralih membutuhkan dua pengaturan: URL dasar https://api.deepseekapikey.com/v1 dan model uncensored.

Copycurl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik di halaman kunci API, berlaku selama 7 hari. Top-up berjalan dari $20 hingga $500 dengan kripto; lihat halaman harga dan dokumentasi untuk detailnya.

Panduan lainnya

• Kunci API DeepSeek: Gratis atau Berbayar? Biaya Nyata
• Kunci API DeepSeek di SillyTavern: Hubungkan API Kami