Hoe na Integreer de DeepSeek API

Vereisten: Omgevingconfiguratie

Begin met het controleren of je ontwikkelomgeving de benodigde SDK geïnstalleerd heeft. Je hebt een taalruntime nodig, zoals Python of Node.js, en een manier om je API-gegevens veilig op te slaan. Deze setup is identiek aan het gebruik van elke andere OpenAI-compatible service.

Je hoeft geen vendor-specifieke drivers te installeren. De proxy regelt alle modelinference, dus je machine hoeft alleen HTTP-verzoeken te sturen en JSON-antwoorden te parseren. Dit vermindert afhankelijkheids-overhead en houdt je project licht.

De officiële SDK installeren

Installeer de officiële SDK voor uw voorkeurstaal om authenticatie en requestserialisatie af te handelen. Voor Python gebruikt u pip install openai. Voor Node.js, voer npm install openai. Deze bibliotheek beheert de onderliggende HTTP-verbindingen.

De SDK abstrahert de complexiteit van het bouwen van JSON-payloads. Je kunt je concentreren op het definiëren van je prompt en het verwerken van de teruggegeven tokens. Deze standaardisering betekent dat je later van provider kunt wisselen door alleen de basis-URL aan te passen.

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)

Basis-URL en sleutel configureren

Wijs uw SDK-client naar de proxy-basis-URL en injecteer uw API-sleutel. Deze configuratiestap leidt het verkeer weg van de standaard OpenAI-servers. U moet de base_url naar https://api.deepseekpago.com/v1.

Voer uw sleutel via de api_key parameter. Deze sleutel wordt gegenereerd wanneer je je aanmeldt op de site. Hij authenticeert je verzoeken en houdt je verbruik van voorbetaald krediet bij. Zonder deze configuratie zullen je verzoeken falen met een 404- of 401-fout.

Je eerste verzoek maken

Stuur een eenvoudige tekstvoltooiing om de connectiviteit en modelgedrag te verifiëren. Gebruik de model-ID uncensored toegang tot het specifieke model dat op de proxy draait. Dit model is afgestemd op antwoorden zonder inhoudsweigeringen voor wettig volwassen gebruik.

De request body bevat de messages array en de model identifier. De response bevat de gegenereerde tekst in de content veld. Dit bevestigt dat uw integratie correct werkt met het uncensored-model.

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

Streaming-antwoorden inschakelen

Activeer streaming door stream: true in je verzoek. Dit retourneert Server-Sent Events (SSE) in plaats van een enkel JSON-object. Je ontvangt tokens zodra ze worden gegenereerd, wat de waargenomen latentie voor eindgebruikers verbetert.

Verwerk de stream door door de chunks te itereren. De laatste chunk bevat het totale tokenverbruik. Dit stelt je in staat om de kosten in real-time te monitoren zonder te wachten tot de volledige respons is voltooid.

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)

Tools en Function Calling gebruiken

Definieer tools in de request body om het model gestructureerde outputs te laten genereren. Stuur een lijst met functiedefinities in de tools parameter. Het model retourneert een functieaanroep in plaats van platte tekst wanneer dat gepast is.

Deze functie werkt precies zoals de OpenAI function calling API. Je kunt dit integreren in je applicatielogica om code uit te voeren of databases bij te werken. De proxy ondersteunt dit standaardprotocol zonder aanpassingen.

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

JSON-uitvoerindeling afdwingen

Forceer het model om geldige JSON uit te geven door response_format naar {"type": "json_object"}. Dit is nuttig voor het parseren van gegevens in je applicatie. Het vermindert de behoefte aan post-processing regex patronen.

Het model houdt zich strikt aan deze beperking. Als de uitvoer geen geldige JSON is, kan het verzoek mislukken. Dit zorgt ervoor dat je pipeline robuust blijft bij integratie met geautomatiseerde systemen. Je kunt ook temperature en top_p instellen om creativiteit te regelen.

Afhandeling van fouten en snelheidslimieten

De API handhaaft een limiet van 300 verzoeken per minuut per sleutel. Als u dit overschrijdt, ontvangt u een 429-fout. U kunt ook maximaal 8 gelijktijdige verzoeken per sleutel hebben. Respecteer deze limieten om serviceonderbrekingen te vermijden.

Fouten worden geretourneerd als standaard JSON-objecten met een foutcode en bericht. Verwerk deze soepel in je code. Voor tijdelijke fouten zoals responsen met 429 of 503 wordt backoff met exponentiële groei aanbevolen.

Monitoring van tokengebruik

Volg je verbruik van vooruitbetaald krediet door tokenaantallen te monitoren. Het laatste chunk in een streaming response bevat de usage object. Dit toont input- en outputtokenaantallen.

Prijzen zijn $0.15 per 1M input tokens en $0.50 per 1M output tokens. Fouten zijn gratis. Je kunt kosten lokaal berekenen door tokenaantallen met deze tarieven te vermenigvuldigen. Dit helpt je je crypto-top-ups nauwkeurig te budgetteren.