Cum că Integrați API-ul DeepSeek

Precondiții: configurarea mediului

Începe prin a te asigura că mediul tău de dezvoltare are SDK-ul necesar instalat. Ai nevoie de un runtime de limbaj, cum ar fi Python sau Node.js, și de o modalitate de a stoca credențialele API în siguranță. Această configurare este identică cu utilizarea oricărui alt serviciu compatibil OpenAI.

Nu trebuie să instalezi drivere specifice furnizorului. Proxy-ul se ocupă de toate inferențele modelelor, astfel încât mașina ta trebuie doar să trimită cereri HTTP și să analizeze răspunsurile JSON. Acest lucru reduce overhead-ul dependențelor și menține proiectul tău ușor.

Instalarea SDK-ului oficial

Instalează SDK-ul oficial pentru limbajul tău preferat pentru a gestiona autentificarea și serializarea. Pentru Python, folosește pip install openaiPentru Node.js, execută npm install openai. Această bibliotecă gestionează conexiunile HTTP de bază.

SDK-ul abstrage complexitatea construirii payload-urilor JSON. Te poți concentra pe definirea promptului și pe gestionarea tokenilor returnați. Această standardizare înseamnă că poți schimba furnizorii mai târziu modificând doar URL-ul de bază.

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)

Configurarea URL-ului de bază și a cheii

Indreptați clientul SDK către URL-ul de bază al proxy-ului și introduceți cheia API. Acest pas de configurare direcționează traficul departe de serverele standard OpenAI. Trebuie să setați base_url pentru https://api.deepseekpago.com/v1.

Transmiteți cheia prin api_key parametru. Această cheie este generată când vă înregistrați pe site. Autentifică solicitările dumneavoaară și urmărește utilizarea creditului preplătit. Fără această configurare, solicitările dumneavoaară vor eșua cu o eroare 404 sau 401.

Realizarea Primei Tale Cereri

Trimiteți o completare text simplă pentru a verifica conectivitatea și comportamentul modelului. Utilizați ID-ul modelului uncensored pentru a accesa modelul specific care rulează pe proxy. Acest model este ajustat să răspundă fără refuzuri de conținut pentru utilizare adultă legală.

Corpul solicitării include messages array și model identificator. Răspunsul conține textul generat în content câmp. Acest lucru confirmă că integrarea ta funcționează corect cu modelul 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"}]
  }'

Activarea răspunsurilor în flux continuu

Activați streaming-ul setând stream: true în cererea ta. Acest lucru returnează Evenimente trimise de server (SSE) în loc de un singur obiect JSON. Primești tokeni pe măsură ce sunt generați, ceea ce îmbunătățește latența percepută pentru utilizatorii finali.

Gestionați fluxul iterând prin fragmente. Fragmentul final conține utilizarea totală a token-urilor. Acest lucru vă permite să monitorizați costurile în timp real fără a aștepta ca întregul răspuns să se completeze.

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)

Utilizând Tool-uri și Function Calling

Definește instrumente în corpul cererii pentru a permite modelului să genereze ieșiri structurate. Trimite o listă de definiții de funcții în tools parametru. Modelul va returna un apel de funcție în loc de text simplu atunci când este potrivit.

Această funcționalitate funcționează exact ca API-ul de apelare a funcțiilor OpenAI. Poți integra aceasta în logica aplicației tale pentru a executa cod sau a actualiza baze de date. Proxy-ul suportă acest protocol standard fără modificări.

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

Activarea formatului de ieșire JSON

Forțează modelul să returneze JSON valid prin setarea response_format pentru {"type": "json_object"}. Acest lucru este util pentru analizarea datelor în aplicația dumneavoastră. Reduce nevoia de modele regex de post-procesare.

Modelul respectă strict această constrângere. Dacă output-ul nu este un JSON valid, solicitarea poate eșua. Acest lucru asigură că fluxul tău de lucru rămâne robust atunci când te integrezi cu sisteme automate. Poți seta, de asemenea, temperatura și top_p pentru a controla creativitatea.

Gestionarea erorilor și a limitelor de rată

API impune o limită de 300 de cereri pe minut per cheie. Dacă depășiți această limită, primiți un cod de eroare 429. De asemenea, puteți avea până la 8 cereri concurente per cheie. Respectați aceste limite pentru a evita întreruperile serviciului.

Erorile sunt returnate ca obiecte JSON standard cu un cod de eroare și un mesaj. Gestionează-le elegant în codul tău. Se recomandă logica de reîncercare cu backoff exponențial pentru erorile tranzitorii, cum ar fi răspunsurile 429 sau 503.

Monitorizarea utilizării tokenilor

Urmărește utilizarea creditului preplătit monitorizând numărul de tokeni. Fragmentul final dintr-un răspuns streaming include usage object. Acesta arată numărul de token-uri de intrare și ieșire.

Prețurile sunt de $0.15 per 1M tokeni de intrare și $0.50 per 1M tokeni de ieșire. Erorile sunt gratuite. Puteți calcula costurile local înmulțind numărul de tokeni cu aceste rate. Acest lucru vă ajută să vă planificați cu precizie reîncărcările în criptomonede.