Ghid de integrare: cheie API deepseek coder

URL de bază și autentificare

Cheia API autentifică fiecare solicitare. Setează URL-ul de bază la https://api.deepseekcoderapikey.com/v1 în configurația clientului tău. Acest URL gestionează atât endpoint-urile de completări chat, cât și cele de modele, fără a necesita segmente suplimentare de cale. Primești o singură cheie per cont, iar generarea uneia noi înlocuiește imediat cheia precedentă.

Stocați cheia într-o variabilă de mediu numită DEEPSEEK_API_KEY sau treceți-o direct în clientul SDK. Endpoint-ul acceptă antete standard, așa că puteți schimba furnizorii modificând doar URL-ul de bază și valoarea cheii. Această abordare funcționează cu Cursor, extensiile VS Code și instrumentele locale de dezvoltare care așteaptă o interfață compatibilă cu OpenAI.

Autentificarea eșuează cu status 401 dacă cheia lipsește sau este invalidă. Utilizați

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"}]
  }'

exemplu pentru a verifica conectivitatea înainte de a integra în logica aplicației dvs.

Endpoint Completări Chat (POST)

Trimite mesaje la POST /v1/chat/completions endpoint folosind ID-ul modelului uncensored. Acest endpoint procesează input text și returnează output text, suportând atât răspunsuri sincrone, cât și în streaming. Puteți configura comportamentul modelului folosind parametri precum temperature, top_p și secvențe stop.

Fereastra de context permite până la 100,000 de tokeni pentru promptul și completarea combinate. Dacă nu specifici o limită max_tokens, modelul implică 2,048 de tokeni per cerere. Folosește

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)

fragment pentru a vedea cum să structurezi o solicitare standard de chat cu SDK-ul oficial OpenAI pentru Python.

Erorile precum creditul insuficient returnează un cod de stare 402, în timp ce cererile malformed returnează 400. Verifică corpul răspunsului pentru mesaje de eroare detaliate pentru a depana rapid structura payload-ului.

Endpoint Modele (GET)

Interogare modelele disponibile trimițând o GET /v1/models solicitare. Acest endpoint returnează o listă de obiecte model, inclusiv uncensored ID-ul modelului. Poți folosi acest endpoint pentru a verifica dacă cheia ta API este validă și dacă serviciul este online înainte de a face cereri de utilizare intensă.

Răspunsul include metadate precum ID-ul modelului, tipul de obiect și informațiile de proprietate. Folosește aceste date pentru a configura dinamic aplicația ta sau pentru a loga modelele disponibile în scopuri de depanare. Endpoint-ul nu necesită un corp, doar antetul standard de autentificare.

Integrarea acestei verificări în secvența de pornire a startup-ului asigură că aplicația ta eșuează rapid dacă API-ul nu este accesibil. De asemenea, te ajută să verifici dacă URL-ul de bază este configurat corect înainte de a continua cu completările reale de chat.

Răspunsuri în streaming (SSE)

Activați fluxul de date setând stream parametrul la true în cererea ta. API-ul returnează un flux de Evenimente trimise de server (SSE), livrând tokenuri pe măsură ce sunt generate. Această abordare reduce latența percepută pentru asistentii de codare și permite actualizări în timp real ale interfeței utilizatorului în aplicația ta.

Fiecare fragment conține conținut parțial, iar fragmentul final include statistici complete de utilizare a token-urilor. Analizează fluxul SSE cu atenție pentru a gestiona întreruperile de rețea și a bufferiza token-urile parțiale. 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)

exemplu demonstrează cum să gestionați fluxul în JavaScript.

Streaming-ul este ideal pentru generarea de cod pe termen lung sau pentru explicații detaliate. Oferă o experiență de utilizare mai fluidă comparativ cu așteptarea răspunsului complet. Asigură-te că clientul tău gestionează corect evenimentul de sfârșit de flux pentru a finaliza răspunsul.

Apelarea funcțiilor și modul JSON

Folosește apelarea de funcții pentru a permite modelului să invoce instrumente externe. Definește funcțiile tale în tools parametru și specifică tool_choice pentru a controla momentul în care modelul utilizează instrumentele. API-ul suportă definiții standard de instrumente, permițându-ți să te integrezi cu serviciile tale backend.

Pentru ieșiri structurate, activați modul JSON setând response_format pentru json_object. Acest lucru forțează modelul să returneze JSON valid, ceea ce este util pentru analizarea datelor de configurare sau a răspunsurilor API.

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);

fragmentul arată cum să configurezi modul JSON în Node.js.

Combină apelarea de funcții cu streaming pentru utilizarea instrumentelor interactive. Modelul poate invoca mai multe instrumente într-un singur rând, permițând fluxuri de lucru complexe în mai mulți pași. Asigură-te că clientul tău gestionează corect ieșirea instrumentelor pentru a menține contextul conversației.

Limite de rată și constrângeri

Cheia ta API este limitată la 300 de cereri pe minut și 8 cereri concurente. Dimensiunea maximă a corpului cererii este de 8 MB. Dacă depășești aceste limite, API-ul returnează o eroare 429 Too Many Requests. Implementează un backoff exponențial în clientul tău pentru a gestiona limitele de rată cu grijă.

Erorile precum 401 indică o cheie invalidă, în timp ce 402 semnalează credit insuficient. Rambursările nu sunt emise pentru credit, dar dublele charge-uri pot fi rezolvate prin pagina de Suport. Creditele nu expiră niciodată, astfel încât vă puteți reîncărca când este convenabil.

Fereastra de context de 100.000 de tokeni se aplică la promptul total și completare. Monitorizează-ți utilizarea tokenilor pentru a rămâne în buget. Folosește sistemul de credit preplătit pentru a plăti doar pentru ceea ce folosești, fără taxe lunare sau abonamente.