Integrációs útmutató fejlesztőknek

Base URL és Hitelesítés

Kezdje azzal, hogy az ügyfélklienst a bázis URL-címünkre irányítja, és adja meg API-kulcsát az Authorization fejlécben. Ez bármelyik OpenAI-kompatibilis SDK-val működik, mert pontosan követjük a standard protokollt. Generálja kulcsát azonnal Google-fiókkal vagy e-mail címmel a API kulcs oldalról; telefonszám nem szükséges. Tartsa biztonságban a kulcsát, és használjon egy aktív kulcsot fiontonként, mivel az új generálása felülírja a régit.

A hitelesítés egyszerű. Adja át a kulcsot a Authorization fejléc minden kéréshez. Rendszerünk ellenőrzi a kulcsot a tokenek feldolgozása előtt, így csak a jogosult fiókok fogyasztják a kreditet. A hiányzó kulcs hiba esetén azonnal 401-es státuszkódot kap.

Első kérés

Küldjön egy szabványos chat completion kérést a kapcsolódás és a válaszminőség tesztelésére. Ez az egyszerű hívás ellenőrzi a kulcsot, és helyesen hitelesíti a fiókot. A modell azonosítója uncensored, amely szöveg bemenetet és kimenetet kezel tartalom-visszautasítások nélkül jogszerű felnőtt tartalomhoz. Cserélje ki a helyőrzőt a tényleges kulcsra és rendszer promptra.

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

Ez a curl parancs bemutatja a minimális szerkezetet. Módosíthatod a messages tömb, hogy tartalmazzon kontextust vagy utasításokat. A válasz a generált szöveget adja vissza a content mező. Ellenőrizze a használati statisztikákat a válasz fejlécében a token fogyasztás monitorozásához.

Python SDK

Használja a hivatalos OpenAI Python könyvtárat az API integrálásához a szkriptjeibe vagy alkalmazásaiba. Állítsa be a base_url és api_key attribútumok a hívások előtt. Ez a megközelítés biztosítja a kompatibilitást a meglévő kódbázisokkal, amelyek már OpenAI modelleket használnak. Szolgáltató között váltás csak két konfigurációs sor módosítását igényli.

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)

A fenti Python snippet bemutatja, hogyan inicializálja a klienst és küld egy kérést. A könyvtár automatikusan kezeli a JSON sorosítást és a válasz elemzését. Hozzáférhet a válaszobjektumhoz a tartalom, a használati statisztikák és a befejezési okok kinyeréséhez. Ez a módszer ideális backend szolgáltatásokhoz vagy adatfeldolgozási folyamatokhoz.

Node SDK

Integrálja API-ját Node.js alkalmazásokba a openai npm csomagot. Konfiguráld az ügyfelet a mi bázis URL-ünkkel és API kulcsoddal, pontosan úgy, mint az OpenAI esetén. Ez lehetővé teszi, hogy ugyanazt a kódszerkezetet használd teszteléshez és produkcióhoz. A SDK támogatja az aszinkron műveleteket a nem blokkoló kérésekhez.

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

Ez a Node.js példa bemutatja egy chat completion kérés küldését. A await kulcsszó biztosítja, hogy a válasz teljesen megérkezzen, mielőtt folytatná. A hibákat try-catch blokkokkal kezelheti a hálózati problémák vagy API-határok gracefully kezelésére. A válasz objektum tartalmazza a generált szöveget és a tokenhasználat részleteit.

Streamelés

Streamelés engedélyezése a tokenről tokenre történő válaszok fogadásához a chat felületek jobb felhasználói élménye érdekében. Állítsa be a stream paramétert állítsa true-ra a kérésben. Az API a generálás során szövegrészleteket ad vissza, lehetővé téve a kimenet valós idejű megjelenítését. Ez jelentősen csökkenti a végfelhasználók számára észlelt késést.

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 fenti streaming kódminta minden egyes chunkot feldolgoz az érkezésekor. A tartalmat azonnal hozzáadhatja egy UI elemhez. Az utolsó chunk tartalmazza a teljes tokenfelhasználási statisztikákat. Ezt a funkciót az összes, helyesen kezelő SSE válaszokat biztosító OpenAI-kompatibilis kliens támogatja.

Korlátok, hibák és kontextus ablak

API-nk szigorú korlátokat ír elő a tisztességes használat és a rendszer stabilitásának biztosítása érdekében. Kulcsonként percenként 300 kérelmet és 8 párhuzamos kérést küldhet. Minden kérelem törzse nem haladhatja meg a 8 MB-ot. Ha túllépi ezeket a korlátokat, az API 429-es státuskódot ad vissza. Várjon néhány másodpercet, majd próbálja újra a kérést. Az érvénytelen kulcsok 401-es, az elégtelen egyenleg pedig 402-es hibát adnak vissza.

A kontextusablak akár 100 000 token támogatását nyújtja bemenet és kimenet együttesen. Kérésenkénti maximális kimenet 16 000 token, vagy 2 048, ha nem adja meg max_tokens. Ez a nagy ablak lehetővé teszi hosszú dokumentumok feldolgozását vagy kiterjedt beszélgetési előzmények fenntartását tömörítés nélkül. A hibák és visszautasítások nem fogyasztanak kreditet, így csak a tényleges használatért fizet.