Bagaimana ke Integrasikan API DeepSeek

Prasyarat: Penyiapan Lingkungan

Mulai dengan memastikan lingkungan pengembangan Anda memiliki SDK yang diperlukan terinstal. Anda memerlukan runtime bahasa seperti Python atau Node.js dan cara untuk menyimpan kredensial API Anda dengan aman. Pengaturan ini identik dengan menggunakan layanan OpenAI-compatible lainnya.

Anda tidak perlu menginstal driver khusus vendor. Proxy menangani semua inferensi model, sehingga mesin Anda hanya perlu mengirim permintaan HTTP dan menguraikan respons JSON. Ini mengurangi beban ketergantungan dan menjaga proyek Anda tetap ringan.

Menginstal SDK Resmi

Instal SDK resmi untuk bahasa pemrograman pilihan Anda agar otentikasi dan serialisasi permintaan ditangani. Untuk Python, gunakan pip install openai. Untuk Node.js, jalankan npm install openai. Perpustakaan ini mengelola koneksi HTTP di bawahnya.

SDK menyederhanakan kompleksitas pembuatan payload JSON. Anda dapat fokus pada definisi prompt dan penanganan token yang dikembalikan. Standarisasi ini memungkinkan Anda mengganti penyedia layanan di kemudian hari hanya dengan mengubah URL dasar.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Mengkonfigurasi URL Dasar dan Kunci

Arahkan SDK Anda ke URL proxy dan suntikkan kunci API Anda. Langkah konfigurasi ini mengarahkan lalu lintas menjauh dari server OpenAI standar. Anda harus mengatur base_url ke https://api.deepseekpago.com/v1.

Masukkan kunci Anda melalui api_key parameter. Kunci ini dibuat saat Anda mendaftar di situs. Kunci ini mengautentikasi permintaan Anda dan melacak penggunaan kredit prabayar Anda. Tanpa konfigurasi ini, permintaan Anda akan gagal dengan kesalahan 404 atau 401.

Melakukan Permintaan Pertama Anda

Kirim penyelesaian teks sederhana untuk memverifikasi konektivitas dan perilaku model. Gunakan ID model uncensored untuk mengakses model spesifik yang berjalan di proxy. Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah.

Badan permintaan mencakup messages array dan model identifier. Respons berisi teks yang dihasilkan dalam content bidang. Ini mengonfirmasi bahwa integrasi Anda berfungsi dengan benar dengan model uncensored.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

Mengaktifkan Respons Streaming

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. Ini mengembalikan Server-Sent Events (SSE) alih-alih objek JSON tunggal. Anda menerima token saat dihasilkan, yang meningkatkan latensi persepsi bagi pengguna akhir.

Tangani stream dengan mengiterasi melalui chunk. Chunk terakhir berisi total penggunaan token. Ini memungkinkan Anda memantau biaya secara real-time tanpa menunggu respons lengkap selesai.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Menggunakan Alat dan Function Calling

Tentukan alat dalam badan permintaan untuk memungkinkan model menghasilkan output terstruktur. Teruskan daftar definisi fungsi dalam tools parameter. Model akan mengembalikan panggilan fungsi alih-alih teks biasa ketika sesuai.

Fitur ini bekerja persis seperti API pemanggilan fungsi OpenAI. Anda dapat mengintegrasikannya ke dalam logika aplikasi Anda untuk mengeksekusi kode atau memperbarui basis data. Proxy mendukung protokol standar ini tanpa modifikasi.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekpago.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Memaksa Format Output JSON

Paksa model untuk mengembalikan JSON valid dengan mengatur response_format ke {"type": "json_object"}. Ini berguna untuk mengurai data ke dalam aplikasi Anda. Ini mengurangi kebutuhan akan pola regex pasca-pemrosesan.

Model ini mematuhi batasan ini secara ketat. Jika output bukan JSON yang valid, permintaan mungkin gagal. Ini memastikan pipeline Anda tetap robust saat mengintegrasikan dengan sistem otomatis. Anda juga dapat mengatur temperature dan top_p untuk mengontrol kreativitas.

Menangani Error dan Batas Kecepatan

API menerapkan batas 300 permintaan per menit per kunci. Jika Anda melebihi ini, Anda akan menerima error 429. Anda juga dapat memiliki hingga 8 permintaan simultan per kunci. Hormati batas ini untuk menghindari gangguan layanan.

Kesalahan dikembalikan sebagai objek JSON standar dengan kode kesalahan dan pesan. Tangani ini dengan baik dalam kode Anda. Logika ulang dengan backoff eksponensial disarankan untuk kesalahan sementara seperti respons 429 atau 503.

Pemantauan Penggunaan Token

Lacak penggunaan kredit prabayar Anda dengan memantau jumlah token. Potongan terakhir dalam respons streaming mencakup usage object. Ini menunjukkan jumlah token input dan output.

Harga adalah $0.15 per 1M token input dan $0.50 per 1M token output. Kesalahan gratis. Anda dapat menghitung biaya secara lokal dengan mengalikan jumlah token dengan tarif ini. Ini membantu Anda menganggarkan pengisian ulang crypto Anda dengan akurat.