Βασικό URL και Αυθεντικοποίηση
Το API μας βρίσκεται στο https://api.huggingfacellmapi.com/v1. Κάνετε έλεγχο ταυτότητας χρησιμοποιώντας ένα Bearer token που στέλνεται στο Authorization header. Δημιουργήστε το κλειδί σας αμέσως μέσω του Get API key σελίδα χρησιμοποιώντας Google ή email. Κρατήστε αυτό το κλειδί ασφαλές· οποιοςδήποτε το διαθέτει μπορεί να ξοδέψει τα προπληρωμένα πιστωτικά σας. Αν το χάσετε, δημιουργήστε ένα νέο για να αντικαταστήσετε το παλιό ενεργό κλειδί. Δεν απαιτείται αριθμός τηλεφώνου για να ξεκινήσετε.
Πρώτη αίτηση με cURL
Στείλτε ένα raw JSON payload για να ελέγξετε το endpoint αμέσως. Χρησιμοποιήστε το model ID uncensored για να παρακάμψετε τα τυπικά φίλτρα. Η ακόλουθη εντολή cURL δείχνει μια βασική αίτηση παραγωγής κειμένου.
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"}]
}'Αυτό επιστρέφει ένα αντικείμενο JSON που περιέχει το παραγόμενο κείμενο. Ελέγξτε το choices array για το πραγματικό περιεχόμενο. Αν λάβετε σφάλμα 401, επαληθεύστε ότι το κλειδί σας είναι σωστό και ενεργό.
Ενσωμάτωση SDK Python
Χρησιμοποιήστε το επίσημο openai Βιβλιοθήκη Python για μια καθαρή διεπαφή. Κατευθύνετε τον πελάτη στο base URL μας και ορίστε το API key σας. Αυτή η προσέγγιση χειρίζεται αυτόματα τις επαναπροσπάθειες και την ανάλυση JSON.
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)Εγκαταστήστε το πακέτο μέσω pip. Στη συνέχεια, καλέστε το endpoint chat completions ακριβώς όπως θα κάνατε με την OpenAI. Το αντικείμενο απόκρισης σας δίνει πρόσβαση στη χρήση tokens και τους λόγους τερματισμού.
Ρύθμιση Πελάτη Node.js
Οι προγραμματιστές JavaScript μπορούν να χρησιμοποιήσουν το openai Node package. Configure the client with our specific base URL. This ensures all requests route through our uncensored servers.
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);Τρέξτε αυτό το απόσπασμα στο περιβάλλον Node. Απεικονίζει μια απλή συγχρονισμένη κλήση. Μπορείτε να το ενσωματώσετε εύκολα σε διαδρομές Express ή serverless συναρτήσεις.
Streaming Αποκρίσεις
Ενεργοποιήστε streaming ρυθμίζοντας stream: true. Ο διακομιστής στέλνει Server-Sent Events (SSE) που περιέχουν μερικά tokens. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους τελικούς χρήστες.
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)Ανάλυση κάθε τμήματος καθώς φτάνει. Το τελευταίο τμήμα περιέχει τη συνολική χρήση tokens για την αίτηση. Αυτό είναι χρήσιμο για τη δημιουργία διεπαφών συνομιλίας που τυπώνουν αποκρίσεις σε πραγματικό χρόνο.
Όρια, Σφάλματα και Context
Το παράθυρο συμφραζομένων είναι 100.000 tokens για prompt και completion συνολικά. Μπορείτε να ζητήσετε έως 16.000 tokens εξόδου. Σφάλματα όπως 401 υποδεικνύουν μη έγκυρο κλειδί, ενώ 402 σημαίνει ανεπαρκές υπόλοιπο. Τα όρια ρυθμού σας περιορίζουν σε 300 αιτήματα ανά λεπτό. Αιτήματα που υπερβαίνουν τα 8 MB σε μέγεθος θα απορριφθούν. Τα σφάλματα κατά την επεξεργασία δεν καταναλώνουν τα credits σας.
