Base URL és Hitelesítés
API-nk itt található: https://api.huggingfacellmapi.com/v1. Hitelesítse magát egy Bearer token segítségével, amelyet a Authorization header. Azonnal hozza létre kulcsát a API kulcs beszerzése oldal Google-fiókkal vagy e-mail címmel. Tartsa biztonságban ezt a kulcsot; bárki, aki birtokolja, költheti a előre fizetett krediteit. Ha elveszíti, generáljon egy újat a régi aktív kulcs helyett. Telefonnummer nincs szükség a kezdéshez.
Első kérés cURL-lal
Küldjön egy nyers JSON payloadt a végpont azonnali teszteléséhez. Használja a modellszámot uncensored a szabványos szűrők megkerüléséhez. A következő cURL parancs egy alapvető szöveggenerálási kérést mutat be.
curl https://api.huggingfacellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the release notes for version three point zero five"}]
}'Ez egy JSON objektumot ad vissza, amely tartalmazza a generált szöveget. Ellenőrizze a choices tömb a tényleges tartalomhoz. Ha 401-es hibát kap, ellenőrizze, hogy a kulcs helyes és aktív-e.
Python SDK Integráció
Használja a hivatalos openai Python könyvtár tiszta felületért. Irányítsa a klienst az alap URL-címünkre, és állítsa be az API-kulcsot. Ez a megközelítés automatikusan kezeli az újrapróbálkozást és a JSON feldolgozást.
from openai import OpenAI
client = OpenAI(base_url="https://api.huggingfacellmapi.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)Telepítse a csomagot pip segítségével. Ezután hívhatja a chat completions végpontot ugyanúgy, mint az OpenAI esetén. A válasz objektum lehetővé teszi a token-használat és a befejezési okok elérését.
Node.js kliens beállítása
A JavaScript fejlesztők használhatják a openai Node csomag. Konfigurálja az ügyfelet az egyedi alap URL-ünkkel. Ez biztosítja, hogy minden kérés a cenzúrázatlan szervereinkre irányuljon.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.huggingfacellmapi.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);Futtassa ezt a kódrészletet Node környezetben. Ez egy egyszerű szinkron hívást demonstrál. Könnyen integrálhatja Express útvonalakba vagy serverless funkciókba.
Streamelési válaszok
Engedélyezze a streamelést úgy, hogy stream: true. A szerver Server-Sent Eventeket (SSE) küld, amelyek részleges tokeneket tartalmaznak. Ez csökkenti a végfelhasználók számára észlelt késleltetést.
stream = 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)Elemezze minden darabot érkezésekor. Az utolsó darab tartalmazza a kérés összes token-használatát. Ez hasznos a chat felületek építéséhez, amelyek valós időben írják ki a válaszokat.
Korlátok, hibák és kontextus
A kontextusablak 100 000 token, prompt és completion együtt. Kérlelhet legfeljebb 16 000 kimeneti token. A 401-es hiba érvénytelen kulcsot jelez, a 402-es pedig elégtelen egyenleget. A sebességkorlát percenként 300 kérésre korlátoz. A 8 MB-nál nagyobb méretű kérések elutasításra kerülnek. A feldolgozás közbeni hibák nem fogyasztanak egyenleget.