Panduan Integrasi untuk Pengembang

URL Dasar dan Autentikasi

Mulailah dengan mengarahkan klien ke URL dasar kami dan menyediakan kunci API Anda di header otorisasi. Ini berfungsi dengan SDK apa pun yang kompatibel dengan OpenAI karena kami mengikuti protokol standar secara persis. Buat kunci Anda secara instan melalui Google atau email di halaman Dapatkan Kunci API; tidak diperlukan nomor telepon. Jaga kerahasiaan kunci Anda dan gunakan satu kunci aktif per akun, karena membuat yang baru akan menggantikan yang lama.

Autentikasi sederhana. Kirim kunci Anda di Authorization header untuk setiap permintaan. Sistem kami memvalidasi kunci sebelum memproses token, memastikan hanya akun yang berwenang yang menggunakan kredit. Kesalahan seperti kunci yang hilang mengembalikan status 401 segera.

Permintaan Pertama

Kirimkan permintaan completion chat standar untuk menguji konektivitas dan kualitas respons. Panggilan sederhana ini memverifikasi kunci Anda dan kredit akun Anda dengan benar. ID modelnya adalah uncensored, yang menangani input dan output teks tanpa penolakan konten untuk penggunaan dewasa yang sah. Ganti placeholder dengan kunci aktual dan prompt sistem Anda.

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

Perintah curl ini menunjukkan struktur minimal yang diperlukan. Anda dapat menyesuaikan messages array untuk menyertakan konteks atau instruksi. Respons mengembalikan teks yang dihasilkan dalam content bidang. Periksa statistik penggunaan di header respons untuk memantau konsumsi token Anda.

SDK Python

Gunakan pustaka Python resmi OpenAI untuk mengintegrasikan API kami ke skrip atau aplikasi Anda. Atur base_url dan api_key atribut sebelum melakukan panggilan. Pendekatan ini memastikan kompatibilitas dengan basis kode yang sudah ada yang sudah menggunakan model OpenAI. Anda dapat beralih antara penyedia hanya dengan mengubah dua baris konfigurasi.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapicost.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)

Snippet Python di atas menunjukkan cara menginisialisasi klien dan mengirim permintaan. Perpustakaan menangani serialisasi JSON dan parsing respons secara otomatis. Anda dapat mengakses objek respons untuk mengekstrak konten, statistik penggunaan, dan alasan penyelesaian. Metode ini sangat ideal untuk layanan backend atau pipa pemrosesan data.

SDK Node

Integrasikan API kami ke dalam aplikasi Node.js menggunakan openai paket npm. Konfigurasikan klien dengan URL dasar kami dan kunci API Anda seperti yang Anda lakukan untuk OpenAI. Ini memungkinkan Anda menggunakan struktur kode yang sama untuk pengujian dan produksi. SDK mendukung operasi asinkron untuk permintaan non-blocking.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapicost.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);

Contoh Node.js ini mendemonstrasikan pengiriman permintaan penyelesaian obrolan. The await kata kunci memastikan respons diterima sepenuhnya sebelum melanjutkan. Anda dapat menangani kesalahan menggunakan blok try-catch untuk mengelola masalah jaringan atau batas API secara elegan. Objek respons berisi teks yang dihasilkan dan detail penggunaan token.

Streaming

Aktifkan streaming untuk menerima respons token demi token guna meningkatkan pengalaman pengguna di antarmuka obrolan. Tetapkan stream parameter menjadi true dalam permintaan Anda. API mengembalikan potongan teks saat dihasilkan, memungkinkan Anda menampilkan output secara real-time. Ini secara signifikan mengurangi latensi yang dirasakan oleh pengguna akhir.

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)

Kode streaming di atas memproses setiap bagian saat tiba. Anda dapat menambahkan konten ke elemen UI segera. Bagian terakhir berisi statistik penggunaan token total. Fitur ini didukung oleh semua klien OpenAI-compatible yang menangani respons SSE dengan benar.

Batas, Error, dan Jendela Konteks

API kami membatasi batas secara ketat untuk memastikan penggunaan yang adil dan stabilitas sistem. Anda diizinkan 300 permintaan per menit dan 8 permintaan konkuren per kunci. Setiap badan permintaan tidak boleh melebihi 8 MB. Jika Anda melebihi batas ini, API mengembalikan kode status 429. Tunggu beberapa detik dan coba lagi permintaan Anda. Error seperti kunci tidak valid mengembalikan 401, dan kredit tidak cukup mengembalikan 402.

Jendela konteks mendukung hingga 100.000 token untuk input dan output secara gabungan. Output maksimal per permintaan adalah 16.000 token, atau 2.048 jika Anda tidak menentukan max_tokens. Jendela besar ini memungkinkan Anda memproses dokumen panjang atau mempertahankan riwayat percakapan ekstensif tanpa pemotongan. Kesalahan dan penolakan tidak mengonsumsi kredit, sehingga Anda hanya membayar untuk penggunaan aktual.