OpenAI Kompatibilis API dokumentáció

Hitelesítés és Base URL beállítás

Az API-kulcsod hitelesíti az összes kérést a szervereinkhez. Jelentkezz be Google vagy e-mail címmel, és másold ki a kulcsot a irányítópultodról. Illeszd be a környezeti változódba mint DEEPSEEK_API_KEY és irányítsd a kliensed erre: https://api.keyapideepseek.com/v1. Ez a base URL bármelyik szabványos OpenAI-kompatibilis könyvtárral működik.

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

A beállítás ellenőrzéséhez listázza az elérhető modelleket. A válasz megerősíti, hogy a kulcs érvényes és aktív. Ez a lépés biztosítja, hogy az integráció a megfelelő szűrés nélküli végpontra mutat, mielőtt promptokat küldene.

Chat Completions végpont

A POST /v1/chat/completions a végpont elfogadja a promptját, és visszaadja a modell válaszát. Egy JSON törzst küld, amely tartalmazza az üzeneteket, a rendszerirányelveket és paramétereket, mint például a hőmérsékletet. A modell azonosítója mindig uncensored. Ez az egyetlen modell kezeli az összes szöveggenerálási igényét útválasztási komplexitás nélkül.

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)

A Python SDK automatikusan kezeli az HTTP kéréseket. Megadja a kulcsot és a bázis URL-t a kliens konstruktorának. A kód többi része tükrözi a szabványos OpenAI mintákat. Ez biztosítja, hogy később váltson szolgáltatót anélkül, hogy át kellene írnia az entire alkalmazás logikáját.

Streamelési válaszok és tokenfelhasználás

Engedélyezze a streamelést úgy, hogy stream: true a kérésben. Az API Server-Sent Events (SSE) darabokból álló streamet ad vissza. Minden darab parciális szöveget és felhasználási statisztikákat tartalmaz. Az utolsó darab tartalmazza a kérés teljes tokenösszegeit.

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)

A streamelés csökkenti a felhasználók számára észlelt késleltetést. A tokeneket megjelenítheti érkezésük során. Ez kritikus fontosságú hosszú szöveggenerálásnál vagy interaktív chat felületeknél. Figyelje a tokenfelhasználást az utolsó darabban a előleges kreditfogyasztás pontos nyomon követéséhez.

JSON mód és függvényhívás

Erőszakolja meg a strukturált kimenetet a beállítással response_format a {"type": "json_object"}. A modell érvényes JSON-t ad vissza szabad szöveg helyett. Ez ideális API-integrációkhoz vagy adatkinyerési feladatokhoz. A promptban definiálhat függvénydefiníciókat is az eszközhasználathoz.

A modell támogatja tool_choice paraméterek. Kikényszeríthet specifikus függvényeket, vagy hagyhatja a modellt dönteni. Ez a rugalmasság lehetővé teszi komplex ügynökök építését. Győződjön meg arról, hogy a függvény sémák szigorúan típusosak, hogy elkerülje a feldolgozási hibákat az ügyfélkódban.

Sebességkorlátok és párhuzamosság

Minden API-kulcs percenként 300 kérésre van korlátozva. Egyidejűleg legfeljebb 8 kérés futtatható. A kérés törzsének maximális mérete 8 MB. Ezek a korlátok megakadályozzák a visszaéléseket, és biztosítják a stabil teljesítményt minden felhasználó számára. A korlátok túllépése 429-es hibát eredményez.

Implementáljon exponenciális backoffot az ügyfélkódban. Kísérje újra a sikertelen kéréseket rövid késleltetés után. Ez zökkenőmentesen kezeli az átmeneti hálózati problémákat. Az előre fizetett hitelt csak a sikeres befejezésekért számítják fel, nem a díjszabási korlát miatt végzett visszakísérésekért.

Hibakezelés és visszautasítások

A 401-es hiba azt jelzi, hogy a kulcs érvénytelen vagy lejárt. A 402-es hiba elégtelen előre fizetett egyenleget jelez. A 429-es hiba azt jelzi, hogy sebességkorlátba ütközött. A modell elutasítja a kiskorúakkal kapcsolatos szexuális tartalmat tartalmazó kéréseket. Minden más törvényes felnőtt tartalom megengedett.

Ellenőrizze a hiba válasz törzsét a részletes üzenetekért. Naplózza ezeket a hibákat az integrációs problémák hibakereséséhez. A sikertelen kérésekért nem fogyaszt el hitelt. Ez az átlátható számlázási modell segít pontosan megjósolni a költségeket rejtett díjak nélkül.

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