DeepSeek API-productielijst

Eindpuntconfiguratie en basis-URL

De eerste stap is je client naar de juiste basis-URL wijzen. We gebruiken de standaard OpenAI-compatibele structuur, wat betekent dat je bestaande SDK's werken zonder grote refactoring. Stel de base_url naar https://api.deepseekunrestricted.com/v1 en configureer je API-sleutel in de autorisatieheader. Deze opstelling zorgt ervoor dat alle standaard endpoints zoals /v1/chat/completions zich precies gedragen zoals gedocumenteerd. Je hoeft je routeringslogica niet te herschrijven.

• Basis-URL: https://api.deepseekunrestricted.com/v1
• Auth Header: Authorization: Bearer YOUR_API_KEY
• Model-ID: uncensored

Deze configuratie stelt je in staat om tussen verschillende modellen te schakelen als je later uitbreidt, maar blijf voor nu bij het enkele uncensored-model. Het eindpunt is ontworpen voor tekst-in, tekst-uit bewerkingen. Het ondersteunt standaardparameters zoals temperature en top_p. Houd je configuratie gecentraliseerd om te voorkomen dat je URLs op meerdere plaatsen hardcode. Dit vermindert het onderhoud als we de API-versie updaten.

Tokenberekening en kostenraming

De kostenraming is afhankelijk van het apart bijhouden van input- en outputtokens. De prijsstructuur is eenvoudig: $0,15 per 1M inputtokens en $0,50 per 1M outputtokens. Fouten en weigeringen verbruiken geen tegoeden, dus je betaalt alleen voor succesvolle verwerking. Dit prepaid-model zorgt ervoor dat je budget strikt wordt beheerd. Je kunt bijbetalen met crypto, met bonussen voor hogere bedragen.

• Invoerkosten: $0,15 per 1M tokens
• Outputkosten: $0.50 per 1M tokens
• Rstitutie's: Geen, maar tegoed verloopt niet

Monitor altijd de usage veld in de respons om je uitgaven nauwkeurig te volgen. Implementeer een lokale teller om kosten te schatten voordat je grote batches verstuurt. Dit voorkomt onverwachte uitputting van je vooruitbetaalde saldo. Onthoud dat het krediet niet verloopt, dus je kunt opwaarderen wanneer prijzen gunstig zijn. Gebruik de bonusniveaus om je koopkracht te maximaliseren. Een opwaardering van $100 geeft je 10% extra krediet, wat je per-token tarief effectief verlaagt.

Stream-antwoorden efficiënt verwerken

Streaming responses verbeteren de gebruikerservaring door content incrementeel te leveren. We ondersteunen Server-Sent Events (SSE) voor realtime tokenlevering. Elke chunk bevat gedeeltelijke tekst en metadata. Parse deze chunks om je UI soepel bij te werken. De laatste chunk bevat het totale tokenverbruik voor de request.

• Activeer streaming door stream: true
• Parseer het SSE-formaat voor gedeeltelijke updates
• Haal gebruikgegevens op uit het laatste chunk.

Verwerk potentiële netwerkonderbrekingen soepel. Probeer mislukte chunks opnieuw indien nodig. Zorg ervoor dat je parser niet-data-evenementen negeert. Deze aanpak vermindert de waargenomen latentie voor lange uitvoeren. Het stelt gebruikers ook in staat voortgang te zien terwijl het model tekst genereert. Implementeer een buffer om tokens te aggregeren voordat je ze weergeeft. Dit voorkomt flikkeren in dynamische interfaces. Sluit de stream-verbinding altijd na ontvangst van het laatste chunk om resources vrij te maken.

Rate limits en concurrency beheren

Rate limits worden gehandhaafd om stabiele prestaties voor alle gebruikers te garanderen. Elke API-sleutel is beperkt tot 300 verzoeken per minuut. Je kunt maximaal acht gelijktijdige verzoeken actief hebben op elk moment. Het overschrijden van deze limieten resulteert in een 429-fout. Implementeer exponentiële backoff om herhaalde pogingen effectief af te handelen.

• Limiet: 300 verzoeken per minuut per sleutel
• Concurrency: 8 gelijktijdige verzoeken
• Lichaamsgrootte: maximaal 8 MB

Blijf uw aanvragenwachtrij bewaken om de limiet voor gelijktijdige aanvragen niet te raken. Gebruik een semaphore of threadpool om parallelle aanvragen te beheren. Log fouten voor limietoverschrijding om patronen te identificeren. Als u een hogere doorvoer nodig heeft, overweeg dan extra sleutels aan te maken, hoewel elke account beperkt is tot één actieve sleutel. Draai sleutels strategisch om de belasting te verdelen. Dit zorgt ervoor dat kritieke taken niet worden geblokkeerd door achtergrondtaken.

Fouthantering en retry logic

Robuuste foutafhandeling voorkomt dat je applicatie crasht tijdens API-aanroepen. We retourneren standaard HTTP-statuscodes om succes of falen aan te geven. Een 4xx-fout betekent meestal een client-side probleem, zoals een ongeldige sleutel of een slecht gevormd verzoek. Een 5xx-fout duidt op een server-side probleem dat zichzelf misschien oplost.

• 4xx: Clientfouten (controleer je verzoek)
• 5xx: Serverfouten (opnieuw proberen met backoff)
• 429: Limiet overschreden (wacht en probeer opnieuw)

Implementeer een retry-mechanisme met exponentiële backoff voor tijdelijke fouten. Probeer niet opnieuw bij 4xx-fouten, tenzij deze verband houden met rate limiting. Log de foutdetails voor foutopsporing. Neem de request-ID op in je logs om supportteams te helpen. Dit helpt bij het snel diagnosticeren van problemen. Afhandeling van netwerktimeouts moet altijd gescheiden zijn van HTTP-fouten. Een mislukt verzoek zou geen tokenbalans moeten verbruiken als er geen tokens zijn verwerkt.

JSON-modus voor gestructureerde data-uitvoer

JSON-modus zorgt ervoor dat het model geldige JSON-structuren uitvoert. Dit is cruciaal voor integratie met andere systemen die gestructureerde gegevens verwachten. Stel de response_format parameter naar {"type": "json_object"}. Dit forceert het model om zich te houden aan JSON-syntaxisregels.

• Instellen response_format naar json_object
• Output valideren met een JSON-parser
• Verwerk schema-schendingen soepel

Hoewel JSON-modus de consistentie verbetert, garandeert het niet dat de schema's correct zijn. Valideer de uitvoer altijd tegen je verwachte schema. Als de uitvoer ongeldig is, probeer het verzoek opnieuw met een strengere prompt. Dit vermindert de behoefte aan nabewerking. Gebruik deze functie voor taken zoals gegevensextractie of configuratiegeneratie. Het zorgt ervoor dat je downstream-systemen voorspelbare invoer ontvangen. Test je JSON-parsinglogica grondig om randgevallen af te handelen.

Functieaanroep en hulpprogrammagebruik

Function calling stelt het model in staat specifieke acties uit te voeren op basis van gebruikersinvoer. Definieer uw functies in de tools parameter. Het model retourneert een functieaanroepobject in plaats van platte tekst. Je applicatie voert de functie uit en retourneert het resultaat naar het model.

• Definieer functies in de tools array
• Parseer de functieoproeprespons
• Resultaten retourneren om het gesprek voort te zetten

Dit maakt complexe workflows mogelijk zoals databasevragen of websurfs. Zorg ervoor dat je functie definities duidelijk en goed gedocumenteerd zijn. Het model is afhankelijk van deze definities om het juiste hulpmiddel te kiezen. Behandel gevallen waarin het model een niet-gedefinieerde functie aanroept. Dit voorkomt fouten in je uitvoeringslogica. Gebruik functieaanroepen om de mogelijkheden van het LLM uit te breiden. Het overbrugt de kloof tussen taalgeneratie en actieuitvoering.

Contextvensterbeheer

Het contextvenster bepaalt hoeveel tekst het model in één keer kan verwerken. Onze API ondersteunt een contextvenster van 100.000 tokens. Dit omvat zowel de prompt als de completion. Houd rekening met de maximale outputlimiet van 16.000 tokens per verzoek. Als je deze overschrijdt, zal het model de respons afkappen.

• Context window: 100.000 tokens
• Maximale uitvoer: 16.000 tokens
• Standaard max output: 2.048 tokens

Implementeer een sliding window- of samenvattingsstrategie voor lange documenten. Hierdoor blijft de context binnen limieten terwijl belangrijke informatie behouden blijft. Houd het aantal tokens in je prompts bij om overflow te vermijden. Afsnijden kan leiden tot onvolledige responsen. Gebruik de max_tokens parameter om de uitvoerlengte te bepalen. Dit helpt kosten en reactietijden te beheren. Plan je tokenbudget zorgvuldig om voldoende ruimte te garanderen voor de redenering van het model.

Beveiliging en sleutelrotatie

Beveiliging is van cruciaal belang wanneer je je API blootstelt aan productiesystemen. Gebruik omgevingsvariabelen om je API-sleutel op te slaan. Vermijd het hardcoderen ervan in je broncode. Draai periodiek sleutels om het risico op blootstelling te minimaliseren. Wij ondersteunen sleutelrotatie via het dashboard.

• Sla sleutels op in omgevingsvariabelen
• Draai sleutels regelmatig
• Monitor gebruik op anomalieën

Implementeer logging om API-gebruik te volgen en ongebruikelijke activiteit op te sporen. Stel meldingen in voor verzoeken met hoog volume. Dit helpt bij het identificeren van mogelijk misbruik of aanvallen. Houd je SDK-versies up-to-date om te profiteren van beveiligingspatches. Gebruik HTTPS voor alle API-kommunicatie. Dit zorgt ervoor dat je gegevens versleuteld zijn tijdens de overdracht. Regelmatige audits van je API-gebruik helpen bij het behouden van goede beveiligingspraktijken.