Βασικό URL και Αυθεντικοποίηση
Η API του Chatterbot βρίσκεται στο https://api.chatterbotapi.com/v1. Κάνετε έλεγχο ταυτότητας με ένα Bearer token στο Authorization header. Το κλειδί σας εμφανίζεται αμέσως μετά την εγγραφή μέσω Google ή email.
- Base URL:
https://api.chatterbotapi.com/v1 - Header:
Authorization: Bearer YOUR_API_KEY
Ένα κλειδί ανά λογαριασμό αντικαθιστά το παλιό άμεσα. Κρατήστε το ασφαλές.
Πρώτη αίτηση
Στείλτε ένα POST request στο /v1/chat/completions με το μοντέλο uncensored. Η API επιστρέφει κείμενο που παράγεται χωρίς τις τυπικές απορρίψεις για νόμιμο περιεχόμενο ενηλίκων.
Ακολουθεί ένα ελάχιστο παράδειγμα cURL:
curl https://api.chatterbotapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the capital city of France"}]
}'Επαληθεύστε ότι η απόκριση περιλαμβάνει το generated text σε choices[0].message.content.
Ενσωμάτωση SDK Python
Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI. Σημειώστε τη βάση URL μας και εισάγετε το key σας. Ο client χειρίζεται αυτόματα τη JSON serialization.
from openai import OpenAI
client = OpenAI(base_url="https://api.chatterbotapi.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)Αυτή η προσέγγιση λειτουργεί τόσο για ροή όσο και για μη ροή κλήσεων. Το ID μοντέλου παραμένει uncensored.
Ρύθμιση SDK Node.js
Εκκινήστε το πακέτο npm OpenAI με τη βάση URL. Αυτό διασφαλίζει συμβατότητα με υπάρχοντες πελάτες OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatterbotapi.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);Ρυθμίστε τη μεταβλητή περιβάλλοντος ή περάστε το κλειδί απευθείας. Το API συμπεριφέρεται όπως οποιαδήποτε τυπική διεύθυνση chat-completions.
Streaming Αποκρίσεις
Ενεργοποιήστε streaming ρυθμίζοντας stream: true. Η API στέλνει Server-Sent Events (SSE). Τα δεδομένα χρήσης tokens εμφανίζονται μόνο στο τελικό chunk.
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)Επεξεργαστείτε κάθε τμήμα καθώς φτάνει. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μακρές εξόδους έως 16,000 tokens.
Όρια και Σφάλματα
Αναμένεται σφάλμα 401 αν το key είναι μη έγκυρο. Ένα σφάλμα 402 σημαίνει ότι το προκαταβλημένο υπόλοιπό σας έχει εξαντληθεί. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν tokens. Περιορίζεστε σε 300 αιτήματα ανά λεπτό. Το παράθυρο συμφραζομένων χωρά 100.000 tokens συνολικά. Τα σώματα των αιτημάτων πρέπει να παραμένουν κάτω από 8 MB.