Integratiegids voor ontwikkelaars

Basis-URL en authenticatie

Wijs je client eerst naar onze basis-URL en lever je API-sleutel in de autorisatieheader. Dit werkt met elke OpenAI-compatible SDK omdat we exact het standaardprotocol volgen. Genereer je sleutel direct via Google of e-mail op de pagina API-sleutel ophalen; er is geen telefoonnummer nodig. Houd je sleutel veilig en gebruik één actieve sleutel per account, omdat het genereren van een nieuwe sleutel de oude vervangt.

Authenticatie is eenvoudig. Stuur uw sleutel in de Authorization header voor elk verzoek. Ons systeem valideert de sleutel voordat tokens worden verwerkt, zodat alleen geautoriseerde accounts tegoed verbruiken. Fouten zoals een ontbrekende sleutel retourneren direct een 401-status.

Eerste verzoek

Stuur een standaard chat-completion verzoek om de verbinding en de antwoordkwaliteit te testen. Deze eenvoudige call verifieert uw sleutel en laadt uw account correct op. De model-ID is uncensored, wat tekstinput en -output verwerkt zonder contentweigeringen voor wettelijk volwassen gebruik. Vervang de placeholder door je daadwerkelijke sleutel en system prompt.

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

Dit curl-commando demonstreert de minimale structuur die vereist is. Je kunt de messages array om context of instructies op te nemen. De respons retourneert de gegenereerde tekst in de content veld. Controleer de gebruikscijfers in de responsheaders om uw tokenverbruik te monitoren.

Python SDK

Gebruik de officiële OpenAI Python-bibliotheek om onze API in je scripts of applicaties te integreren. Stel de base_url en api_key attributen voordat je verzoeken doet. Deze aanpak zorgt voor compatibiliteit met bestaande codebases die al OpenAI-modellen gebruiken. Je kunt van provider wisselen door slechts twee regels configuratie te wijzigen.

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)

De Python-code hierboven toont hoe je de client initialiseert en een verzoek verzendt. De bibliotheek verwerkt JSON-serialisatie en responsparsering automatisch. Je kunt het response-object toegang geven om inhoud, gebruikstatistieken en finishredenen te extraheren. Deze methode is ideaal voor backenddiensten of dataprocessing-pipelines.

Node SDK

Integreer onze API in Node.js-toepassingen met de openai npm package. Configureer de client met onze basis-URL en je API-sleutel net zoals je dat zou doen voor OpenAI. Dit stelt je in staat om dezelfde codestructuur te gebruiken voor zowel testen als productie. De SDK ondersteunt asynchrone bewerkingen voor niet-blokkerende verzoeken.

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

Dit Node.js-voorbeeld demonstreert het verzenden van een chat-completie-verzoek. De await keyword zorgt ervoor dat de respons volledig is ontvangen voordat je doorgaat. Je kunt fouten afhandelen met try-catch blokken om netwerkproblemen of API-limits soepel te beheren. Het response-object bevat de gegenereerde tekst en token-gebruikdetails.

Streaming

Schakel streaming in om token-voor-token reacties te ontvangen voor een betere gebruikerservaring in chatinterfaces. Stel de stream parameter naar true in je verzoek. De API retourneert tekstchunks zodra ze worden gegenereerd, zodat je de uitvoer in real-time kunt weergeven. Dit vermindert de waargenomen latentie voor eindgebruikers aanzienlijk.

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)

De bovenstaande streamingcode verwerkt elke chunk zodra deze aankomt. U kunt de inhoud direct aan een UI-element toevoegen. De laatste chunk bevat de totale tokenverbruiksstatistieken. Deze functie wordt ondersteund door alle OpenAI-compatible clients die SSE-antwoorden correct verwerken.

Limieten, fouten en contextvenster

Onze API hanteert strikte limieten om eerlijk gebruik en systeemstabiliteit te garanderen. U mag 300 verzoeken per minuut en 8 gelijktijdige verzoeken per sleutel uitvoeren. Elk verzoeklichaam mag niet groter zijn dan 8 MB. Als u deze limieten overschrijdt, retourneert de API een 429-statuscode. Wacht een paar seconden en probeer uw verzoek opnieuw. Fouten zoals ongeldige sleutels retourneren 401, en onvoldoende krediet retourneert 402.

Het contextvenster ondersteunt tot 100.000 tokens voor zowel input als output gecombineerd. Maximaal 16.000 tokens uitvoer per verzoek, of 2.048 als je dit niet specificeert max_tokens. Dit grote venster stelt je in staat lange documenten te verwerken of uitgebreide gespreksgeschiedenis te behouden zonder truncatie. Fouten en refusies verbruiken geen tegoed, dus je betaalt alleen voor daadwerkelijk gebruik.