Γρήγορη Εκκίνηση & Ενσωμάτωση API

Βασικό URL και Αυθεντικοποίηση

Το Heretic Project παρέχει ένα μοναδικό, φιλοξενούμενο endpoint για παραγωγή κειμένου. Χρησιμοποιήστε https://api.hereticproject.com/v1 ως τη βάση URL. Η πιστοποίηση βασίζεται σε ένα bearer token που περνά μέσω του Authorization header. Δημιουργήστε το κλειδί σας συνδεόμενοι με Google ή email στο dashboard. Το σύστημα εκδίδει ένα ενεργό κλειδί ανά λογαριασμό· η δημιουργία ενός νέου κλειδιού ακυρώνει το προηγούμενο αμέσως.

Πληρώνετε μόνο για τα καταναλωθέντα tokens. Τα σφάλματα και οι απορρίψεις δεν χρεώνουν το προκαταβλημένο πιστωτικό σας ποσό. Ένας νέος λογαριασμός λαμβάνει $0.50 σε πιστωτικό δοκιμής, έγκυρο για 7 ημέρες. Κάνετε προσθήκη χρησιμοποιώντας USDT (TRC20) ή USDC (Base) σε ποσά μεταξύ $20 και $500.

Το Endpoint /v1/chat/completions

Στείλτε μηνύματα στην τυπική διεπαφή ολοκλήρωσης συνομιλίας. Το model ID είναι uncensored. Δέχεται μια λίστα αντικειμένων μηνυμάτων με ρόλους όπως system, user, ή assistant. Το μοντέλο δεν απορρίπτει νόμιμα, φανταστικά ή αμφιλεγόμενα θέματα ενήλικων. Είναι ένα μοντέλο ανοιχτού βάρους βελτιστοποιημένο για άμεσες απαντήσεις.

Οι αιτήσεις επιστρέφουν ένα αντικείμενο JSON που περιέχει το παραγόμενο κείμενο. Το παράθυρο συμφραζομένων υποστηρίζει 100,000 tokens συνολικά για προτροπή και συμπλήρωση. Η έξοδο περιορίζεται στα 16,000 tokens ανά αίτηση εκτός αν ορίσετε χαμηλότερο max_tokens value.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Ενσωμάτωση SDK Python

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI με μια βάση URL. Ορίστε api_key στην αλυσίδα API σας. Διαμορφώστε base_url για να δείχνει στον server του Heretic Project. Αυτό σας επιτρέπει να χρησιμοποιήσετε εξοικειωμένες μεθόδους όπως chat.completions.create() χωρίς να τροποποιήσετε σημαντικά τη δομή του υπάρχοντος κώδικά σας.

Εγκαταστήστε τη βbibλιοθήκη μέσω pip. Δώστε τα διαπιστευτήριά σας απευθείας στην αρχικοποίηση του πελάτη. Η βιβλιοθήκη διαχειρίζεται τη σειριοποίηση αυτόματα. Αυτή η προσέγγιση λειτουργεί τόσο για συγχρονικές όσο και για ασύγχρονες ροές εργασίας. Βεβαιωθείτε ότι διαχειρίζεστε ενδεχόμενα σφάλματα δικτύου με χάρη.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticproject.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)

Node SDK Integration

Το Node.js SDK λειτουργεί ταυτόσημα με την έκδοση Python. Αρχικοποιήστε τον πελάτη με το API key και τη σωστή βάση URL. Μπορείτε να στείλετε αιτήματα completion χρησιμοποιώντας τις ίδιες υπογραφές μεθόδων. Αυτό διασφαλίζει τη συνέπεια σε διάφορα μέρη του stack σας.

Διαχειριστείτε τις απαντήσεις ασύγχρονα. Το SDK ρέει δεδομένα αν χρησιμοποιήσετε τη μέθοδο ροής. Διαφορετικά, επιστρέφει την πλήρη απάντηση JSON. Αυτή η ευελιξία υποστηρίζει τόσο την επεξεργασία παρτίδων όσο και τις διεπαφές πραγματικού χρόνου. Κρατήστε το κλειδί API σας ασφαλές στις μεταβλητές περιβάλλοντος.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.hereticproject.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);

Streaming Αποκρίσεις (SSE)

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Ο διακομιστής στέλνει Server-Sent Events (SSE). Κάθε τμήμα περιέχει ενημερώσεις μερικού κειμένου. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για τους τελικούς χρήστες. Τα δεδομένα χρήσης tokens εμφανίζονται στο τελικό τμήμα της ροής.

Επεξεργαστείτε κάθε αντικείμενο delta για να συσσωρεύσετε την πλήρη απάντηση. Διακόψτε την ακρόαση όταν το stream κλείσει ή προκύψει σφάλμα. Αυτή η μέθοδος είναι ιδανική για διεπαφές chat. Επιτρέπει στους χρήστες να βλέπουν τις σκέψεις να διαμορφώνονται σε πραγματικό χρόνο. Το επιπλέον κόστος είναι ελάχιστο σε σύγκριση με τις πλήρεις απαντήσεις.

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)

Όρια, Σφάλματα και Context

Σεβαστείτε τα όρια ρυθμού για να αποφύγετε διακοπές στην υπηρεσία. Επιτρέπονται 300 αιτήματα ανά λεπτό ανά κλειδί. Η ταυτόχρονη χρήση περιορίζεται σε 8 ταυτόχρονες συνδέσεις. Το σώμα του αιτήματος δεν μπορεί να υπερβαίνει τα 8 MB. Η υπέρβαση αυτών των ορίων επιστρέφει κωδικό κατάστασης 429. Περιμένετε λίγο πριν κάνετε επανάληψη.

Οι αποτυχίες πιστοποίησης επιστρέφουν σφάλμα 401. Αυτό συμβαίνει αν το key είναι άκυρο ή ληγμένο. Ένα σφάλμα 402 υποδεικνύει ανεπαρκά prepaid credit. Τα λάθη επιστροφής χρημάτων διαχειρίζονται μέσω της σελίδας Support. Το credit δεν λήγει ποτέ. Το μοντέλο απορρίπτει περιεχόμενο που αφορά ανηλίκους. Όλο το άλλο νόμιμο περιεχόμενο γίνεται αποδεκτό.