OpenAI-yhteensopiva API-dokumentaatio

Todennus ja Base URL -asetukset

API-avaimesi todentaa jokaisen pyynnön palvelimillemme. Rekisteröidy vain Google- tai sähköpostitunnuksella ja kopioi avain työkalupaudiltasi. Liitä se ympäristömuuttujaasi muodossa DEEPSEEK_API_KEY and point your client to https://api.keyapideepseek.com/v1. Tämä base URL toimii minkä tahansa standardin OpenAI-yhteensopivan kirjaston kanssa.

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

Voit varmistaa asetuksesi luomalla listan saatavilla olevista malleista. Vastaus vahvistaa, että avaintasi on voimassa ja aktiivinen. Tämä vaihe varmistaa, että integraatiosi osoittaa oikeaan suodattamattomaan päätepisteeseen ennen syötteiden lähettämistä.

Chat Completions Endpoint

The POST /v1/chat/completions päätepiste hyväksyy syötteesi ja palauttaa mallin vastauksen. Lähetät JSON-runkon, joka sisältää viestit, järjestelmäohjeesi ja parametrit kuten lämpötilan. Mallin tunnus on aina uncensored. Tämä yksittäinen malli käsittelee kaikki tekstigenerointitarpeesi ilman reitityksen monimutkaisuutta.

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)

Python-SDK hoitaa HTTP-pyyntöjen automaattisesti. Syötät avaimen ja base URL -arvon asiakasrakentajalle. Loput koodista peilaa standardia OpenAI-kuvioita. Tämä varmistaa, että voit vaihtaa toimittajaa myöhemmin ilman koko sovelluslogiikan uudelleenkirjoittamista.

Streamausvastaukset ja merkkikäyttö

Ota streamaus käyttöön asettamalla stream: true pyynnössäsi. API palauttaa Server-Sent Events (SSE) -streamin osioista. Jokainen osio sisältää osittaista tekstiä ja käyttötilastoja. Viimeinen osio sisältää pyynnön tokenien kokonaismäärät.

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)

Streamaus vähentää käyttäjien kokemaa viiveettä. Voit näyttää tokenit saapumisen mukana. Tämä on ratkaisevaa pitkän tekstin tuotannolle tai interaktiivisille chatrajapinnoille. Seuraa token-käyttöä viimeisessä lohkossa prepaid-tilin kulutuksen tarkkaan seurantaan.

JSON-tila ja funktiokutsut

Pakota rakenteellinen tuloste asettamalla response_format vastaan {"type": "json_object"}. Malli palauttaa kelvollisen JSON-muodon vapaamuotoisen tekstin sijasta. Tämä on ihanteellinen API-integraatioihin tai tietojen erotteluun. Voit myös määritellä funktiomäärittelyt pyyntöösi työkalukäyttöä varten.

Malli tukee tool_choice parametrit. Voit pakottaa tiettyjä toimintoja tai antaa mallin päättää. Tämä joustavuus mahdollistaa monimutkaisten agenttien rakentamisen. Varmista, että toimintoskeemasi ovat tarkasti tyypitettyjä välttääksesi jäsentimisvirheet asiakaskoodissasi.

Nopeusrajoitukset ja samanaikaisuus

Jokaiselle API-avaimelle on rajoitettu 300 pyyntöä minuutissa. Voit käyttää enintään 8 samanaikaista pyyntöä. Pyynnön rungon enimmäiskoko on 8 Mt. Nämä rajat estävät väärinkäytön ja varmistavat vakaan suorituskyvyn kaikille käyttäjille. Näiden rajojen ylittäminen palauttaa virhekoodin 429.

Ota eksponentiaalinen backoff -käsittely käyttöön asiakaskoodissa. Toista epäonnistuneet pyynnöt lyhyen viiveen jälkeen. Tämä käsittelee tilapäiset verkkovirheet sujuvasti. Esimaksullinen luottosi laskutetaan vain onnistuneista suorituksista, ei nopeusrajoitusten vuoksi tehdyistä toistoista.

Virheenkäsittely ja hylkäykset

Virhe 401 tarkoittaa, että avain on virheellinen tai vanhentunut. Virhe 402 tarkoittaa, että esimaksukrediitti on riittämätön. Virhe 429 ilmoittaa, että osuit nopeusrajoitukseen. Malli hylkää pyynnöt, jotka sisältävät seksuaalista sisältöä, joka liittyy alaikäisiin. Muu laillinen aikuis sisältö on sallittua.

Tarkista virhevastauksen runko yksityiskohtaisten viestien varmistamiseksi. Lokita nämä virheet integraatiovirheiden debuggingia varten. Luottamuksesi ei kuluta epäonnistuneissa pyynnöissä. Tämä läpinäkyvä laskutusmalli auttaa sinua ennustamaan kustannuksia tarkasti ilman piilokuluja.

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