Τεκμηρίωση API: Quickstart Guide

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

Το API Heretic AI είναι πλήρως συμβατό με OpenAI. Αλληλεπιδράτε με αυτό κατευθύνοντας τον πελάτη σας στη βάση URL μας: https://api.hereticai.cc/v1. Ο έλεγχος ταυτότητας βασίζεται σε ένα μοναδικό API key ανά λογαριασμό, που δημιουργείται άμεσα κατά την εγγραφή μέσω Google ή email. Περνάστε αυτό το key στο Authorization header ως Bearer token. Το αναγνωριστικό μοντέλου είναι απλώς uncensored.Αυτό το μοναδικό μοντέλο διαχειρίζεται όλες τις αιτήσεις σας χωρίς πολυπλοκότητα δρομολόγησης. Σφάλματα όπως 401 υποδεικνύουν μη έγκυρο κλειδί, ενώ 402 σημαίνει ότι χρειάζεστε περισσότερο προκαταβλημένο κρυπτονομισματικό υπόλοιπο.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Τερματικό Συμπληρώματος Συζήτησης

Στείλτε αιτήσεις κειμένου χρησιμοποιώντας το POST /v1/chat/completions endpoint. Το API περιμένει ένα τυπικό messages array που περιέχει το ιστορικό συνομιλίας ή το prompt σας. Επιστρέφει παραγόμενο κείμενο στο choices array. Αυτή είναι μια καθαρή API χρήσης: κείμενο εισόδου, κείμενο εξόδου. Πληρώνετε μόνο για τα tokens που καταναλώθηκαν. Τα προπληρωμένα πιστωτικά μονάδα δεν λήγουν ποτέ, και οι απορρίψεις ή τα σφάλματα δεν κοστίζουν tokens. Αυτή η προσέγγιση εξαλείφει τους δεσμούς συνδρομής και τα απρόβλεπτα δωρεάν επίπεδα.

Copyfrom openai import OpenAI

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

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

Ενεργοποιήστε τη ροή token σε πραγματικό χρόνο ρυθμίζοντας stream: true στην αίτησή σας. Το API επιστρέφει Server-Sent Events (SSE) για κάθε παράγόμενο token. Αυτό σας επιτρέπει να εμφανίζετε το αποτέλεσμα προοδευτικά, κάτι που είναι κρίσιμο για εφαρμογές ευαίσθητες στην καθυστέρηση. Τα στατιστικά χρήσης tokens εμφανίζονται στο τελευταίο chunk της ροής. Αυτή η λειτουργία λειτουργεί ομαλά με τα τυπικά OpenAI SDKs που διαχειρίζονται τα SSE αυτόματα. Παρέχει άμεση ανατροφοδότηση χωρίς να περιμένετε την πλήρη ολοκλήρωση.

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)

Function Calling και Εργαλεία

Η API υποστηρίζει κλήση συναρτήσεων με την tools και tool_choice parameters. Ορίστε τα schemas των εργαλείων σας στο αίτημα, και το μοντέλο θα επιστρέψει δομημένες κλήσεις συναρτήσεων όταν αυτό είναι κατάλληλο. Αυτό επιτρέπει σύνθετα workflows όπου το LLM αποφασίζει ποια ενέργεια να λάβει στη συνέχεια. Μπορείτε να επιβάλετε συγκεκριμένη χρήση εργαλείων ή να αφήσετε το μοντέλο να επιλέξει ελεύθερα. Αυτή η δυνατότητα είναι απαραίτητη για την κατασκευή agentic εφαρμογών που αλληλεπιδρούν με εξωτερικά συστήματα ή βάσεις δεδομένων.

Λειτουργία JSON

Βεβαιωθείτε για ντετερμινιστική έξοδο ρυθμίζοντας response_format για {"type": "json_object"}. Το μοντέλο θα περιορίσει την απάντησή του σε έγκυρο JSON, το οποίο είναι ζωτικό για προγραμματισμένη ανάλυση. Αυτό μειώνει την ανάγκη για διορθώσεις regex μετα-επεξεργασίας. Εγγυάται ότι η έξοδος μπορεί να καταναλωθεί άμεσα από τον κώδικά σας. Αυτό είναι ιδιαίτερα χρήσιμο για εξαγωγή δομημένων δεδομένων ή παραγωγή διαμορφώσεων.

Παράμετροι και Όρια

Ελέγξτε τη δημιουργία με τυπικές παραμέτρους όπως temperature, top_p, και seed. Το παράθυρο συνάφειας είναι 100.000 tokens για prompt συν completion. Μέγιστη έξοδος είναι 16.000 tokens ανά αίτηση, ή 2.048 αν max_tokens είναι μη ρυθμισμένο. Τα όρια ρυθμού είναι 300 αιτήσεις ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά κλειδί. Το σώμα της αίτησης πρέπει να παραμένει κάτω από 8 MB. Αυτά τα όρια διασφαλίζουν σταθερή χρήση υψηλού όγκου για προγραμματιστές.

Node.js

Copyimport OpenAI from "openai";

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