getdeepseekapi.comPanduan
URL API DeepSeek dan Base URL: Cara Mengubah
URL API DeepSeek yang Anda salin dari dokumentasi resmi DeepSeek adalah Base URL, dan hanya berfungsi dengan kunci DeepSeek serta model DeepSeek. Jika Anda ingin endpoint gaya OpenAI lain, ubah URL tersebut, kunci, dan ID model.
Diperbarui
Poin utama
- Base URL adalah awalan; SDK menambahkan /chat/completions ke dalamnya.
- Layanan ini menggunakan https://api.getdeepseekapi.com/v1 dengan ID model uncensored.
- Ini bukan API DeepSeek, sehingga kunci DeepSeek tidak akan berfungsi di sini, dan sebaliknya.
- Klien lain juga menerima URL dan kunci melalui OPENAI_BASE_URL dan OPENAI_API_KEY.

Base URL, endpoint, dan jalur: tiga bagian tersebut
Orang sering menempelkan alamat lengkap ke dalam bidang yang mengharapkan awalan, lalu mendapat 404. Tiga istilah ini meluruskannya.
- URL dasar: awalan bersama dari setiap panggilan, misalnya
https://api.getdeepseekapi.com/v1. Ini yang Anda masukkan ke pengaturan "API base" atau "URL dasar" klien. - Path endpoint: bagian yang ditambahkan oleh SDK, seperti
/chat/completions,/responsesatau/models. - URL lengkap: base ditambah path, seperti
https://api.getdeepseekapi.com/v1/chat/completions. Klien HTTP mentah seperti curl membutuhkan ini.
Aturan yang sering membuat bingung: SDK dan aplikasi meminta URL dasar, curl dan node HTTP meminta URL lengkap. Jika alat memberi 404, periksa dulu apakah Anda memasukkan URL lengkap di tempat yang seharusnya URL dasar, atau sebaliknya. Jalur ganda seperti /v1/chat/completions/chat/completions dalam error adalah pertanda jelas.
Apa URL dasar DeepSeek itu, dan apa yang bukan
DeepSeek menerbitkan alamat API-nya sendiri dalam dokumentasinya, bersama dengan nama model yang dapat digunakan kuncinya. Lihat di sana untuk nilai terkini daripada mempercayai postingan blog, termasuk ini. Kunci DeepSeek berfungsi terhadap endpoint DeepSeek dan tidak di tempat lain.
Layanan di situs ini adalah produk terpisah. Ini bukan API DeepSeek resmi, tidak meneruskan ke DeepSeek dan tidak melayani model DeepSeek. Ini adalah API yang kompatibel dengan OpenAI yang dihosting untuk satu model bobot terbuka, dijalankan oleh penyedia independen dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Alamatnya adalah:
https://api.getdeepseekapi.com/v1 # model: uncensored
ID model adalah uncensored, dan autentikasi adalah Authorization: Bearer <key>. Kunci diterbitkan di halaman kunci API. Jika Anda membandingkan arti kunci untuk setiap layanan, halaman kunci API DeepSeek memiliki detail lebih lanjut.
Mengubah endpoint di SDK OpenAI
Semua SDK OpenAI bekerja setelah Anda mengubah URL dasar dan kuncinya. Di Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
Di Node.js bidangnya dieja baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
Perhatikan perbedaannya: Python menggunakan base_url, Node menggunakan baseURL. Mengacaukannya secara diam-diam akan kembali ke alamat OpenAI default, yang kemudian akan menolak kunci Anda.
Beralih tanpa menyentuh kode
SDK OpenAI resmi membaca dua variabel lingkungan, sehingga aplikasi yang ada dapat diarahkan ulang tanpa perubahan kode:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
Nama model adalah bagian yang tidak boleh dilewatkan. Jika aplikasi meng-hardcode ID model lain, aplikasi itu akan meminta model tersebut dan gagal, jadi ubah menjadi uncensored di pengaturan atau konfigurasi aplikasi. Banyak alat menampilkan ketiga nilai ini di satu layar pengaturan, biasanya diberi label URL dasar API, kunci API, dan model.
Pertukaran tiga nilai yang sama berfungsi dalam framework. Dengan LangChain di Python, misalnya, ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored") sudah cukup. Alat coding yang menerima endpoint kompatibel OpenAI bekerja dengan cara yang sama; lihat panduan di menggunakan API untuk coding.
HTTP mentah: path yang tepat
Untuk curl, skrip, dan node HTTP yang Anda buat, Anda membuat URL lengkap sendiri. Berikut adalah path pada layanan ini:
| Tujuan | Metode dan URL |
|---|---|
| Chat | POST https://api.getdeepseekapi.com/v1/chat/completions |
| API Respons | POST https://api.getdeepseekapi.com/v1/responses |
| Daftar model | GET https://api.getdeepseekapi.com/v1/models |
| Saldo | GET https://api.getdeepseekapi.com/v1/balance |
| Saldo, dengan gaya OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Gunakan HTTPS saja. Streaming bekerja dengan "stream": true melalui event yang dikirim server, dan URL yang sama melayani kedua mode tersebut.
Memasukkan URL ke dalam aplikasi dengan layar pengaturan
Banyak antarmuka obrolan, editor dan alat otomatisasi memiliki opsi "endpoint kompatibel OpenAI kustom". Labelnya berbeda, tetapi bidangnya dipetakan satu per satu:
| Bidang di aplikasi | Nilai |
|---|---|
| URL dasar API, URL Dasar, Titik Akhir, URL Server | https://api.getdeepseekapi.com/v1 |
| Kunci API, Token, Rahasia | Kunci Anda dari layanan ini |
| Model, Nama model, ID model | uncensored |
Beberapa aplikasi menginginkan URL obrolan lengkap, bukan URL dasar. Dalam hal ini, gunakan https://api.getdeepseekapi.com/v1/chat/completions. Jika aplikasi memiliki tombol "tes koneksi", biasanya tombol itu memanggil daftar model, yaitu GET /v1/models. Jika tombol gagal tetapi obrolan manual berhasil, pemeriksaan aplikasi lebih ketat daripada API, dan Anda dapat mengabaikannya.
Tes dasar untuk URL saja
Sebelum Anda men-debug aplikasi, verifikasi URL dengan daftar model. Permintaan ini tidak memerlukan body dan tidak ada biaya:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
Anda akan menerima kembali JSON dengan array data. Halaman error HTML berarti host atau path salah, seperti subdomain yang hilang: host dimulai dengan api., bukan www..
Memperbaiki kesalahan umum
- 404 Tidak Ditemukan. URL dasar kehilangan
/v1, memilikinya dua kali, atau menyertakan jalur endpoint. - 401 atau error autentikasi. Anda menggunakan kunci dari layanan lain, atau header tidak memiliki
Bearer. Kunci tidak dapat dipertukarkan antar penyedia. - Model tidak ditemukan. Permintaan masih menyebut model dari penyedia lama. Atur
uncensored. - Aplikasi masih terhubung ke layanan lama. Beberapa alat menyimpan pengaturan dalam cache atau membaca variabel yang berbeda. Mulai ulang prosesnya dan periksa layar pengaturan.
- Masalah slash di akhir. Sebagian besar klien menangani ini, tetapi jika ada yang tidak bisa, hapus slash terakhir dari URL dasar.
Jika Anda tidak yakin sisi mana yang gagal, kirimkan perintah curl di atas. Tanggapan 200 membuktikan URL, kunci, dan model; apa pun yang rusak lainnya ada di aplikasi Anda. dokumentasi mencantumkan batas dan header seperti X-Request-Id, yang membantu saat Anda menghubungi dukungan.
Apa yang tetap sama setelah migrasi
Bentuk permintaan dan respons mengikuti format OpenAI, sehingga array pesan, temperature, top_p, stop, seed, penalti, pemanggilan fungsi, dan mode JSON semuanya berfungsi seperti biasa. Jendela konteks adalah 100.000 token untuk prompt ditambah completion, dan body permintaan maksimum adalah 8 MB. Layanan ini hanya teks: tidak ada gambar, audio, embedding, atau fine-tuning, sehingga fitur yang dibangun di atasnya memerlukan penyedia lain.
Penagihan juga terpisah dari penyedia lama: $0,15 per 1M token input dan $0,50 per 1M token output dari saldo prabayar, seperti yang ditunjukkan di halaman harga. Pengguna baru dapat mengklaim kredit uji coba sebesar $0,50 untuk memastikan pengalihan berfungsi sebelum membayar apa pun.
Panduan lainnya
Tanya jawab
Apa URL dasar API DeepSeek?
DeepSeek mempublikasikannya dalam dokumentasinya sendiri, jadi periksa di sana untuk nilai terkini. Endpoint di situs ini adalah layanan berbeda di https://api.getdeepseekapi.com/v1.
Bisakah saya menggunakan kunci DeepSeek pada endpoint ini?
Tidak. Kunci dikeluarkan per layanan. Dapatkan kunci untuk API ini di halaman kunci, dan atur model ke uncensored.
Haruskah base URL diakhiri dengan /v1?
Ya untuk layanan ini: https://api.getdeepseekapi.com/v1. SDK menambahkan jalur endpoint setelahnya, jadi jangan tambahkan /chat/completions sendiri.
Mengapa saya mendapatkan 404 setelah mengubah URL?
Biasalnya jalur digandakan atau /v1 hilang. Bandingkan URL dasar Anda dengan nilai tepat di atas.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.