Bas URL och autentisering
Vårt API finns på https://api.huggingfacellmapi.com/v1. Du autentiserar med en Bearer-token som skickas i Authorization header. Generera din nyckel omedelbart via Hämta API-nyckel sida genom att använda Google eller e-post. Behåll den här nyckeln säker; alla som har den kan spendera dina förbetalda krediter. Om du tappar bort den, generera en ny för att ersätta den gamla aktiva nyckeln. Inget telefonnummer krävs för att börja.
Första förfrågan med cURL
Skicka en rå JSON-payload för att testa slutpunkten omedelbart. Använd modell-ID:t uncensored för att kringgå standardfilter. Följande cURL-kommando demonstrerar en grundläggande textgenereringsbegäran.
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"}]
}'Detta returnerar ett JSON-objekt som innehåller den genererade texten. Kontrollera att choices array för det faktiska innehållet. Om du får ett 401-fel, verifiera att din nyckel är korrekt och aktiv.
Python SDK-integration
Använd det officiella openai Python-bibliotek för ett rent gränssnitt. Pek klienten mot vår bas-URL och ange din API-nyckel. Denna metod hanterar automatiskt omförsök och JSON-parsing.
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)Installera paketet via pip. Du kan sedan anropa chattkompletteringsändpunkten precis som du skulle göra med OpenAI. Svarsobjektet ger dig tillgång till tokenanvändning och avslutningsorsaker.
Node.js-klientkonfiguration
JavaScript-utvecklare kan använda openai Node-paket. Konfigurera klienten med vår specifika bas-URL. Detta säkerställer att alla förfrågningar riktas genom våra obegränsade servrar.
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);Kör detta kodstycke i din Node-miljö. Det demonstrerar ett enkelt synkront anrop. Du kan enkelt integrera detta i Express-rutter eller serverlösa funktioner.
Strömningsresponser
Aktivera strömning genom att ställa in stream: true. Servern skickar Server-Sent Events (SSE) som innehåller delvisa tokens. Detta minskar uppfattad latens för slutanvändare.
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)Analysera varje chunk när den anländer. Den sista chunken innehåller total tokenanvändning för begäran. Detta är användbart för att bygga chattgränssnitt som skriver ut svar i realtid.
Gränser, fel och kontext
Kontextrutan är 100 000 tokens för prompt och svar tillsammans. Du kan begära upp till 16 000 utdatatokens. Fel som 401 anger en ogiltig nyckel, medan 402 betyder otillräckligt kredit. Hastighetsbegränsningar maximerar dig till 300 begäranden per minut. Begäranden som överstiger 8 MB i storlek kommer att avslås. Fel under bearbetningen förbrukar inte dina krediter.