Panduan Pengintegrasian: kunci API deepseek coder

URL Asas dan Pengesahan

Kunci API anda mengesahkan setiap permintaan. Tetapkan URL asas kepada https://api.deepseekcoderapikey.com/v1 dalam konfigurasi klien anda. URL ini mengendalikan kedua-dua akhiran penyelesaian sembang dan akhiran model tanpa memerlukan segmen laluan tambahan. Anda menerima satu kunci per akaun, dan menjana kunci baharu akan menggantikan kunci sebelumnya serta-merta.

Simpan kunci dalam pembolehubah persekitaran bernama DEEPSEEK_API_KEY atau luluskan terus ke klien SDK anda. Hujung sambungan menerima header standard, jadi anda boleh menukar penyedia dengan menukar hanya URL asas dan nilai kunci. Pendekatan ini berfungsi dengan Cursor, sambungan VS Code, dan alat pembangunan tempatan yang mengharapkan antara muka serasi OpenAI.

Pengesahan gagal dengan status 401 jika kunci hilang atau tidak sah. Gunakan

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

contoh untuk mengesahkan sambungan sebelum berintegrasi ke dalam logik aplikasi anda.

Hujung Sambungan Penyelesaian Sembang (POST)

Hantar mesej ke POST /v1/chat/completions endpoint menggunakan ID model uncensored. Hujung sambungan ini memproses input teks dan mengembalikan output teks, menyokong kedua-dua respons segerak dan aliran. Anda boleh mengkonfigurasi tingkah laku model menggunakan parameter seperti suhu, top_p, dan jeda hentian.

Jendela konteks membolehkan sehingga 100,000 token untuk gabungan prompt dan penyelesaian. Jika anda tidak menentukan had max_tokens, model akan menggunakan lalai 2,048 token setiap permintaan. Gunakan

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.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 untuk melihat cara menyusun permintaan semakan piawai dengan SDK Python rasmi OpenAI.

Kesalahan seperti kredit tidak mencukupi memulangkan kod status 402, manakala permintaan yang rosak memulangkan 400. Semak badan respons untuk mesej ralat terperinci untuk nyahpepiayan struktur payload anda dengan cepat.

Hujung Model (GET)

Query model yang tersedia dengan menghantar GET /v1/models permintaan. Hujung sambungan ini mengembalikan senarai objek model, termasuk uncensored ID model. Anda boleh menggunakan hujung sambungan ini untuk mengesahkan bahawa kunci API anda sah dan bahawa perkhidmatan dalam talian sebelum membuat permintaan penggunaan berat.

Respons termasuk metadata seperti ID model, jenis objek, dan maklumat kepemilikan. Gunakan data ini untuk mengkonfigurasi aplikasi anda secara dinamik atau untuk log model yang tersedia untuk tujuan nyahpepihantan. Titik akhir ini tidak memerlukan badan, hanya header pengesahan standard.

Mengintegrasikan pemeriksaan ini ke dalam urutan permulaan aplikasi anda memastikan aplikasi anda gagal dengan cepat jika API tidak dapat dicapai. Ia juga membantu anda mengesahkan bahawa URL asas yang betul telah dikonfigurasi sebelum meneruskan dengan penyelesaian chat sebenar.

Respons Streaming (SSE)

Aktifkan penstriman dengan menetapkan stream parameter kepada true dalam permintaan anda. API mengembalikan aliran Acara Dikirim Pelayan (SSE), menghantar token sejajar dengan penjanaan. Pendekatan ini mengurangkan latensi yang dirasakan untuk pembantu pengekodan dan membolehkan kemas kini UI secara masa nyata dalam aplikasi anda.

Setiap chunk mengandungi kandungan separa, dan chunk akhir termasuk statistik penggunaan token keseluruhan. Hantar aliran SSE dengan teliti untuk menangani gangguan rangkaian dan penampan token separa. The

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)

contoh menunjukkan cara mengendalikan aliran dalam JavaScript.

Streaming sesuai untuk penjanaan kod bentuk panjang atau penjelasan terperinci. Ia memberikan pengalaman pengguna yang lebih lancar berbanding menunggu keseluruhan respons. Pastikan klien anda mengendalikan acara akhir aliran dengan betul untuk menyelesaikan respons.

Panggilan Fungsi dan Mod JSON

Gunakan panggilan fungsi untuk membolehkan model memanggil alat luaran. Takrifkan fungsi anda dalam tools parameter dan nyatakan tool_choice untuk mengawal bila model menggunakan alat. API menyokong definisi alat standard, membolehkan anda berintegrasi dengan perkhidmatan backend anda sendiri.

Untuk output terstruktur, aktifkan mod JSON dengan menetapkan response_format ke json_object. Ini memaksa model mengembalikan JSON yang sah, yang berguna untuk menguraikan data konfigurasi atau respons API. The

Copyimport OpenAI from "openai";

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

snippet menunjukkan cara mengkonfigurasi mod JSON dalam Node.js.

Gabungkan panggilan fungsi dengan penstriman untuk penggunaan alat interaktif. Model boleh memanggil beberapa alat dalam satu giliran, membolehkan aliran kerja berbilang langkah yang kompleks. Pastikan klien anda mengendalikan output alat dengan betul untuk mengekalkan konteks perbualan.

Had had laju dan kekangan

Kunci API anda terhad kepada 300 permintaan setiap minit dan 8 permintaan serentak. Saiz badan permintaan maksimum ialah 8 MB. Jika anda melebihi had ini, API akan mengembalikan ralat 429 Too Many Requests. Laksanakan backoff eksponen dalam klien anda untuk mengendalikan had kadar dengan baik.

Kesilapan seperti 401 menunjukkan kunci tidak sah, manakala 402 menandakan kredit tidak mencukupi. Bayaran balik tidak dikeluarkan untuk kredit, tetapi caj berganda boleh diselesaikan melalui halaman Sokongan. Kredit tidak pernah luput, jadi anda boleh menambah apabila mudah.

Jendela konteks 100,000 token terpakai untuk jumlah prompt dan penyelesaian. Pantau penggunaan token anda untuk kekal dalam bajet. Gunakan sistem kredit pra-dibayar untuk membayar hanya untuk apa yang anda gunakan, tanpa yuran bulanan atau langganan.