Integrationsguide för utvecklare

Bas URL och autentisering

Börja med att peka din klient mot vår bas-URL och ange din API-nyckel i auktoriseringshuvudet. Detta fungerar med alla OpenAI-kompatibla SDK:er eftersom vi följer standardprotokollet exakt. Generera din nyckel omedelbart via Google eller e-post på sidan Hämta API-nyckel; inget telefonnummer krävs. Håll din nyckel säker och använd en aktiv nyckel per konto, eftersom att generera en ny ersätter den gamla.

Autentiseringen är enkel. Skicka din nyckel i Authorization header för varje begäran. Vårt system validerar nyckeln innan tokens bearbetas, vilket säkerställer att endast auktoriserade konton förbrukar kredit. Fel som en saknad nyckel returnerar omedelbart en 401-status.

Första förfrågan

Skicka en standardbegäran om chattkomplettering för att testa anslutning och svarskvalitet. Detta enkla anrop verifierar din nyckel och krediterar ditt konto korrekt. Modell-ID:t är uncensored, vilket hanterar textinmatning och -utmatning utan innehållsavslag för laglig vuxenanvändning. Ersätt platshållaren med din faktiska nyckel och systemprompt.

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

Denna curl-kommando demonstrerar den minimala strukturen som krävs. Du kan justera messages array för att inkludera sammanhang eller instruktioner. Svaret returnerar den genererade texten i content fält. Kontrollera användningsstatistiken i svarshuvudena för att övervaka din tokenförbrukning.

Python SDK

Använd det officiella OpenAI Python-biblioteket för att integrera vår API i dina skript eller applikationer. Ange base_url och api_key attribut innan du gör anrop. Detta säkerställer kompatibilitet med befintliga kodbasar som redan använder OpenAI-modeller. Du kan växla mellan leverantörer genom att ändra bara två konfigurationsrader.

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)

Python-snippeten ovan visar hur du initierar klienten och skickar en förfrågan. Biblioteket hanterar JSON-serialisering och svarsparsing automatiskt. Du kan använda svarobjektet för att extrahera innehåll, användningsstatistik och avslutningsorsaker. Denna metod är idealisk för backend-tjänster eller dataprocessningspipelines.

Node SDK

Integrera vårt API i Node.js-applikationer med openai npm-paket. Konfigurera klienten med vår bas-URL och din API-nyckel precis som du skulle göra för OpenAI. Detta gör att du kan använda samma kodstruktur för både testning och produktion. SDK:t stöder asynkrona operationer för icke-blockerande begäranden.

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

Detta Node.js-exempel visar hur man skickar en chat-completion-begäran. Den await nyckelord säkerställer att svaret tas emot helt innan du fortsätter. Du kan hantera fel med hjälp av try-catch-block för att hantera nätverksproblem eller API-begränsningar på ett smidigt sätt. Svarsobjektet innehåller den genererade texten och detaljer om tokenanvändning.

Strömning

Aktivera strömning för att ta emot token-för-token-svar för bättre användarupplevelse i chattgränssnitt. Ställ in stream parameter till true i din begäran. API:et returnerar textbitar när de genereras, vilket gör att du kan visa utdata i realtid. Detta minskar den upplevda latensen för slutanvändare avsevärt.

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)

Koden ovan streamar varje chunk när den anländer. Du kan lägga till innehållet direkt i ett UI-element. Den sista chunken innehåller statistik över total tokenanvändning. Denna funktion stöds av alla OpenAI-kompatibla klienter som hanterar SSE-svar korrekt.

Gränser, fel och kontextfönster

Vårt API tillämpar strikta gränser för att säkerställa rättvis användning och systemstabilitet. Du har tillstånd att göra 300 begäranden per minut och 8 samtidiga begäranden per nyckel. Varje begärandekropp får inte överstiga 8 MB. Om du överskrider dessa gränser returnerar API:t statuskoden 429. Vänta några sekunder och försök igen med din begäran. Fel som ogiltiga nycklar returnerar 401, och otillräckligt kreditbelopp returnerar 402.

Kontextfönstret stöder upp till 100 000 tokens för både inmatning och output kombinerat. Maximal output per begäran är 16 000 tokens, eller 2 048 om du inte anger max_tokens. Detta stora fönster gör att du kan bearbeta långa dokument eller upprätthålla omfattande konversationshistorik utan avklippning. Fel och refus konsumerar inte kredit, så du betalar endast för faktisk användning.