Integraatio-opas kehittäjille

Perus-URL ja todennus

Aloita osoittamalla asiakasohjelma base URL -osoitteeseemme ja toimittamalla API-avaimesi authorization-headeriin. Tämä toimii minkä tahansa OpenAI-yhteensopivan SDK:n kanssa, koska noudatamme standardia protokollaa tarkasti. Luo avaimesi välittömästi Googlen tai sähköpostin avulla Get API key -sivulla; puhelinnumeroa ei vaadita. Pidä avain turvassa ja käytä yhtä aktiivista avainta per tili, sillä uuden luominen korvaa vanhan.

Todennus on yksinkertaista. Lähetä avaimesi kenttään Authorization header jokaista pyyntöä varten. Järjestelmämme validoi avaimen ennen tokenkäsittelyä, varmistaen, että vain valtuutetut tilit käyttävät luottoa. Virheet kuten puuttuva avain palauttavat 401-tilakoodin välittömästi.

Ensimmäinen pyyntö

Lähetä vakio chat-completion pyyntö yhteyden ja vastauksen laadun testaamiseen. Tämä yksinkertainen kutsu varmistaa, että avaimesi ja tiliysi kreditti ovat oikein. Mallin tunnus on uncensored, joka käsittelee tekstisisäntöä ja -lähtöä ilman sisältökelpoisuuden kieltoja lailliseen aikuissisältöön. Korvaa paikkamerkki omalla todellisella avallasi ja järjestelmäkehotteella.

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

Tämä curl-komento demonstroi vaadittua vähimmäisrakennetta. Voit säätää messages tietorakenteella sisällyttääksesi kontekstin tai ohjeet. Vastauksessa tuotettu teksti palautetaan content kenttä. Tarkista käyttötilastot vastauksen otsikoista seurataksesi token-kulutustasi.

Python SDK

Käytä virallista OpenAI:n Python-kirjastoa API:n integroimiseen skripteihisi tai sovelluksiisi. Aseta base_url ja api_key attribuutit ennen kutsujen tekemistä. Tämä varmistaa yhteensopivuuden olemassa olevien koodikantojen kanssa, jotka käyttävät jo OpenAI-malleja. Voit vaihtaa tarjoajaa muuttamalla vain kahta konfiguraatioviivaa.

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)

Yllä oleva Python-pätkä näyttää, miten alustaa asiakas ja lähettää pyynnön. Kirjasto hoitaa JSON-serialisoinnin ja vastauksen jäsentämisen automaattisesti. Voit käyttää vastausobjektia poimiaksesi sisällön, käyttötilastot ja lopetusperusteet. Tämä menetelmä on ihanteellinen taustapalveluille tai datakäsittelyputkille.

Node SDK

Integroi API-me Node.js-sovelluksiin käyttäen openai npm-paketti. Konfiguroi asiakas perus-URL:llämme ja API-avaimesi aivan kuten tekisit OpenAI:n kanssa. Tämä mahdollistaa saman koodirakenteen käytön sekä testauksessa että tuotannossa. SDK tukee asynkronisia operaatioita ei-pysäyttävien pyyntöjen varmistamiseksi.

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

Tämä Node.js-esimerkki demonstroi chat-täydennyspyynnön lähettämistä. The await avainsana varmistaa, että vastaus vastaanotetaan kokonaan ennen jatkamista. Voit käsitellä virheet try-catch-lohkolla hallitaksesi verkkovirheet tai API-rajoitukset joustavasti. Vastausobjekti sisältää luodun tekstin ja token-käytön tiedot.

Virtaus

Ota suoratoisto käyttöön vastaanottaaksesi token kerrallaan -vastaukset paremman käyttökokemuksen saavuttamiseksi chatrajapinnoissa. Aseta stream parametri arvoon true pyynnössäsi. API palauttaa tekstiosia niiden luomisen aikana, mikä mahdollistaa tulosten näyttämisen reaaliajassa. Tämä vähentää pääkäyttäjien havaitsemaa viivettä merkittävästi.

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)

Yllä oleva stream-koodi käsittelee jokaisen osan saapuessaan. Voit liittää sisällön käyttöliittymäelementtiin välittömästi. Viimeinen osan sisältää kokonaisten tokenien käyttötilastot. Tätä ominaisuutta tukevat kaikki OpenAI-yhteensopivat asiakkaat, jotka käsittelevät SSE-vastaukset oikein.

Rajoitukset, virheet ja kontekstiikkuna

APIemme asettaa tiukat rajat varmistamaan reilun käytön ja järjestelmän vakauden. Sinulla on oikeus tehdä 300 pyyntöä minuutissa ja 8 samanaikaista pyyntöä per avain. Jokaisen pyynnön rungon koon ei saa ylittää 8 MB. Jos ylität nämä rajat, API palauttaa 429-tilakoodin. Odota muutama sekunti ja yritä pyyntöä uudelleen. Virheet kuten virheellinen avain palauttavat 401, ja riittämätön saldo palauttaa 402.

Kontekstiluukku tukee jopa 100 000 tokenia sekä syötteelle että vastaukselle yhteensä. Maksimivastaus pyyntöä kohden on 16 000 tokenia tai 2 048, jos et määritä max_tokens. Tämä suuri ikkuna mahdollistaa pitkien dokumenttien käsittelyn tai laajan keskusteluhistorian ylläpitämisen ilman katkaisua. Virheet ja sulatukset eivät kuluta kredittiä, joten maksat vain todellisesta käytöstä.