OpenAI Compatibele API Documentatie

Authenticatie en basis-URL-instelling

Je API-sleutel authenticeert elk verzoek aan onze servers. Meld je eenvoudig aan via Google of een e-mailadres en kopieer de sleutel vanuit je dashboard. Plak deze in je omgevingsvariabele als DEEPSEEK_API_KEY en wijs je client aan op https://api.keyapideepseek.com/v1. Deze basis-URL werkt met elke standaard OpenAI-compatible bibliotheek.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

U kunt uw setup verifiëren door de beschikbare modellen op te lijsten. De respons bevestigt dat uw sleutel geldig en actief is. Deze stap zorgt ervoor dat uw integratie naar het juiste uncensored-eindpunt wijst voordat u prompts verstuurt.

Chat Completions Endpoint

De POST /v1/chat/completions endpoint accepteert je prompt en retourneert de modelrespons. Je stuurt een JSON-body met berichten, je systeem-instructies en parameters zoals temperatuur. De model id is altijd uncensored. Dit enkele model verwerkt al je tekstgeneratiebehoeften zonder routeringscomplexiteit.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapideepseek.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)

De Python SDK verwerkt de HTTP-verzoeken automatisch. Je geeft je sleutel en de basis-URL door aan de clientconstructor. De rest van de code spiegelt standaard OpenAI-patronen. Dit zorgt ervoor dat je van aanbieder kunt wisselen zonder je hele applicatielogica te herschrijven.

Streaming-responsen en tokengebruik

Activeer streaming door stream: true in je verzoek. De API retourneert een Server-Sent Events (SSE)-stream van delen. Elk deel bevat gedeeltelijke tekst en verbruiksstatistieken. Het laatste deel bevat de totale aantallen tokens voor het verzoek.

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)

Streaming vermindert de waargenomen latentie voor gebruikers. Je kunt tokens weergeven zodra ze binnenkomen. Dit is cruciaal voor het genereren van lange teksten of interactieve chatinterfaces. Monitor het tokenverbruik in het laatste deel om het verbruik van je prepaid-krediet nauwkeurig bij te houden.

JSON-modus en functaanroeping

Forceer gestructureerde uitvoer door response_format naar {"type": "json_object"}. Het model zal geldige JSON retourneren in plaats van vrije tekst. Dit is ideaal voor API-integraties of data-extractietaken. Je kunt ook functiedefinities in je prompt definiëren voor toolgebruik.

Het model ondersteunt tool_choice parameters. Je kunt specifieke functies afdwingen of het model de keuze laten. Deze flexibiliteit stelt je in staat complexe agents te bouwen. Zorg dat je funtieschema's strikt getypt zijn om parserfouten in je clientcode te voorkomen.

Rate Limits en gelijktijdigheid

Elke API-sleutel is beperkt tot 300 verzoeken per minuut. U kunt maximaal 8 gelijktijdige verzoeken actief hebben. De maximale grootte van de request body is 8 MB. Deze limieten voorkomen misbruik en zorgen voor stabiele prestaties voor alle gebruikers. Het overschrijden van deze limieten resulteert in een 429-fout.

Implementeer exponentiële backoff in je clientcode. Probeer mislukte verzoeken opnieuw na een korte vertraging. Dit behandelt tijdelijke netwerkproblemen soepel. Je voorgebetaalde krediet wordt alleen in rekening gebracht voor succesvol voltooide verzoeken, niet voor retries die worden beperkt door rate limits.

Fouthantering en Weigeringen

Een 401-fout betekent dat uw sleutel ongeldig of verlopen is. Een 402-fout geeft aan dat er onvoldoende vooruitbetaald krediet is. Een 429-fout geeft aan dat u de snelheidslimiet hebt bereikt. Het model weigert verzoeken die seksuele inhoud met minderjarigen bevatten. Alle andere wettelijke volwassen inhoud is toegestaan.

Controleer de foutresponsbody voor gedetailleerde berichten. Log deze fouten om integratieproblemen te debuggen. Je krediet wordt niet verbruikt voor mislukte verzoeken. Dit transparante facturatiemodel helpt je kosten nauwkeurig te voorspellen zonder verborgen kosten.

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapideepseek.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);