Miten DeepSeek API:n integroimiseksi

Edellytykset: Ympäristön määritys

Aloita varmistamalla, että kehitysympäristössäsi on tarvittava SDK asennettuna. Tarvitset kieliajoaikaympäristön, kuten Pythonin tai Node.js:n, ja tavan säilyttää API-kirjautumistietosi turvallisesti. Tämä asennus on identtinen minkä tahansa muun OpenAI-yhteensopivan palvelun kanssa.

Et tarvitse asentaa toimittajakohtaisia ajureita. Välityspalvelin hoitaa kaikki mallien päättelyt, joten koneesi tarvitsee vain lähettää HTTP-pyyntöjä ja jäsentää JSON-vastauksia. Tämä vähentää riippuvuuksien yhdistyksiä ja pitää projektisi kevyenä.

Virallisen SDK:n asennus

Asenna kielikohtainen virallinen SDK, joka hoitaa autentikoinnin ja serialisoinnin. Pythonissa käytä pip install openai. Node.js:lle suorita npm install openai. Tämä kirjasto hallinnoi taustalla olevia HTTP-yhteyksiä.

SDK abstrahoi JSON-payloadien rakentamisen monimutkaisuuden. Voit keskittyä määrittämään promptisi ja käsittelemään palautettuja tokenneja. Tämä standardointi tarkoittaa, että voit vaihtaa tarjoajaa myöhemmin muuttamalla vain base URL -arvoa.

Copyfrom openai import OpenAI

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

Perus-URL-osoitteen ja avaimen määrittäminen

Osoita SDK-asiakkaasi välityspalvelimen base URLiisi ja ruiskuta API-avaimesi. Tämä määritysvaihe ohittaa liikenteen standardien OpenAI-palvelimien pois. Sinun on asetettava base_url vastaan https://api.deepseekpago.com/v1.

Vie avaimesi api_key parametri. Tämä avain luodaan rekisteröityessäsi sivustolle. Se todentaa pyyntösi ja seuraa esimaksullisen krediittisi käyttöä. Ilman tätä määritystä pyyntösi epäonnistuvat 404- tai 401-virheellä.

Ensimmäisen pyynnön tekeminen

Lähetä yksinkertainen tekstikomplettointi yhteensopivuuden ja mallin käyttäytymisen varmistamiseksi. Käytä mallin tunnus uncensored päästäksesi käsiksi tiettyyn proxyssa toimivaan malliin. Tämä malli on hienosäänetty vastaamaan ilman sisältöhylkäyksiä lailliseen aikuiskäyttöön.

Pyyntöruumis sisältää messages taulukko ja model identifier. The response contains the generated text in the content kenttä. Tämä vahvistaa, että integrointisi toimii oikein uncensored-mallin kanssa.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

Suoratoistovastausten käyttöönotto

Ota streamaus käyttöön asettamalla stream: true pyynnössäsi. Tämä palauttaa Server-Sent Events -tapahtumavirran (SSE) yksittäisen JSON-objektin sijaan. Saat tokenit niiden tuotannon aikana, mikä parantaa käyttäjien kokemaa viiveen tuntumaa.

Käsittele virtaa iteroimalla lohkojen läpi. Viimeinen lohko sisältää kokonaisten tokenien käytön. Tämä mahdollistaa kustannusten seurannan reaaliajassa odottamatta koko vastauksen valmistumista.

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)

Kun käytät työkaluja ja function callingia

Määritä työkalut pyynnön runkoon mahdollistaaksesi mallin tuottamaan rakenteisia tulosteita. Välitä lista funktiomäärittelyjä tools parametri. Malli palauttaa funktiokutsun puhtaan tekstin sijaan, kun se on aiheellista.

Tämä ominaisuus toimii täsmälleen kuten OpenAI:n funktiokutsu-API. Voit integroida sen sovelluksesi logiikkaan koodin suorittamiseksi tai tietokantojen päivittämiseksi. Välityspalvelin tukee tätä vakioprotokollaa ilman muutoksia.

Copyimport OpenAI from "openai";

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

JSON-lähtömuodon pakottaminen

Pakota malli palauttamaan kelvollinen JSON asettamalla response_format vastaan {"type": "json_object"}. Tämä on hyödyllistä datan jäsentämisessä sovellukseesi. Se vähentää tarvetta jälkikäsittelyyn regexp-kuvioilla.

Malli noudattaa tätä rajoitusta tiukasti. Jos tuloste ei ole kelvollista JSONia, pyyntö voi epäonnistua. Tämä varmistaa, että putkesta pysyy vakaana integroitessa automaattisiin järjestelmiin. Voit myös asettaa lämpötilan ja top_p:n hallitaksesi luovuutta.

Virheiden ja nopeusrajoitusten käsittely

API rajoittaa 300 pyyntöä minuutissa per avain. Jos ylityt tämän, saat 429-virheen. Voit myös tehdä enintään 8 samanaikaista pyyntöä per avain. Nouda näitä rajoja välttääksesi palvelukatkoksia.

Virheet palautetaan standardien JSON-objekteina, joissa on virhekoodi ja viesti. Käsittele nämä hienotunteisesti koodissasi. Suositellaan retry-logiikkaa eksponentiaalisella viiveellä väliaikaisiin virheisiin, kuten 429- tai 503-vastauksiin.

Token-käytön valvonta

Seuraa esimaksutason käyttöä valvomalla tokenimääriä. Streamausvastauksen viimeinen pätkä sisältää usage object. Tämä näyttää syöte- ja tulostokenien määrät.

Hinnat ovat $0.15 per 1M syöttötokenia ja $0.50 per 1M lähtötokenia. Virheet ovat ilmaisia. Voit laskea kustannukset paikallisesti kertomalla tokenmäärät näillä nopeuksilla. Tämä auttaa sinua budjetoida krypto-topauksesi tarkasti.