Integrationsguide til udviklere

Base URL og autentificering

Start med at pege din klient mod vores base URL og angive din API-nøgle i authorization-headeren. Dette fungerer med ethvert OpenAI-kompatibelt SDK, fordi vi følger den standardiserede protokol nøjagtigt. Generer din nøgle øjeblikkeligt via Google eller e-mail på siden 'Get API key'; der kræves ikke et telefonnummer. Hold din nøgle sikker, og brug kun én aktiv nøgle pr. konto, da generering af en ny erstatter den gamle.

Autentificering er simpel. Send din nøgle i Authorization header til hver anmodning. Vores system validerer nøglen, før tokens behandles, hvilket sikrer, at kun autoriserede konti forbruger kredit. Fejl som en manglende nøgle returnerer straks en 401-statuskode.

Første anmodning

Send en standard chat-completionsanforing for at teste forbindelsen og svar kvaliteten. Denne enkle opkald verificerer din nøgle og krediterer din konto korrekt. Model-ID er uncensored, som håndterer tekstinput og -output uden indholdsafvisninger til lovligt voksenbrug. Erstat pladsholderen med din faktiske nøgle og 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"}]
  }'

Denne curl-kommando demonstrerer den minimale struktur, der er nødvendig. Du kan justere messages array for at inkludere kontekst eller instruktioner. Svaret returnerer den genererede tekst i content felt. Tjek brugsstatistikken i response-headerne for at overvåge dit tokenforbrug.

Python SDK

Brug det officielle OpenAI Python-bibliotek til at integrere vores API i dine scripts eller applikationer. Indstil base_url og api_key attributter, før du laver opkald. Denne tilgang sikrer kompatibilitet med eksisterende kodebaser, der allerede bruger OpenAI-modeller. Du kan skifte mellem udbydere ved blot at ændre to linjer konfiguration.

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-snippetet ovenfor viser, hvordan man initialiserer klienten og sender en anmodning. Biblioteket håndterer JSON-serialisering og svarparsning automatisk. Du kan tilgå svarobjektet til at udtrække indhold, forbrugsstatistik og finish-årsager. Denne metode er ideel til backend-tjenester eller databehandlingspipelines.

Node SDK

Integrer vores API i Node.js-applikationer ved hjælp af openai npm-pakke. Konfigurer klienten med vores base-URL og din API-nøgle, ligesom du ville gøre for OpenAI. Dette giver dig mulighed for at bruge den samme kodestruktur til både test og produktion. SDK'et understøtter asynkrone operationer til ikke-blokerende anmodninger.

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

Denne Node.js-eksempel demonstrerer afsendelse af en chat-completion-anmodning. The await nøgleord sikrer, at svaret modtages fuldt ud, før du fortsætter. Du kan håndtere fejl ved hjælp af try-catch-blokke til at håndtere netværksproblemer eller API-grænser elegant. Svarobjektet indeholder den genererede tekst og tokenforbrugsdetaljer.

Streaming

Aktivér streaming for at modtage token-for-token-svar for en bedre brugeroplevelse i chatgrænseflader. Indstil stream parameter til true i din anmodning. API'et returnerer tekstchunks, mens de genereres, hvilket giver dig mulighed for at vise output i realtid. Dette reducerer den opfattede latens for slutbrugere betydeligt.

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 ovenfor streamer hver enkelt chunk, når den ankommer. Du kan tilføje indholdet til et UI-element med det samme. Den sidste chunk indeholder statistik over det samlede tokenforbrug. Denne funktion understøttes af alle OpenAI-kompatible klienter, der håndterer SSE-svar korrekt.

Begrænsninger, fejl og kontekstvindue

Vores API har strenge grænser for at sikre rimelig brug og systemstabilitet. Du har tilladelse til 300 requests i minuttet og 8 samtidige requests per nøgle. Hver request-body må ikke overstige 8 MB. Hvis du overskrider disse grænser, returnerer API'et en 429-statuskode. Vent et par sekunder og prøv din request igen. Fejl som ugyldige nøgler returnerer 401, og utilstrækkelig kredit returnerer 402.

Kontekstvinduet understøtter op til 100.000 tokens til både input og output kombineret. Maks output pr. anmodning er 16.000 tokens, eller 2.048, hvis du ikke angiver max_tokens. Dette store vindue giver dig mulighed for at behandle lange dokumenter eller opretholde omfattende samtalehistorik uden afkortning. Fejl og afvisninger forbruger ikke kredit, så du betaler kun for faktisk forbrug.