Γρήγορη Έναρξη Ενσωμάτωσης Character api

Εγκαταστήστε το SDK

Ξεκινήστε εγκαθιστώντας την επίσημη βιβλιοθήκη πελάτη για τη γλώσσα σας. Αυτό διασφαλίζει τη συμβατότητα με το endpoint συμβατό με το OpenAI που παρέχουμε. Η βιβλιοθήκη αναλαμβάνει τη σειριοποίηση και τη λογική επαναπροσπάθειας για εσάς.

Για Python, χρησιμοποιήστε το pip. Για Node.js, χρησιμοποιήστε το npm. Αυτό το βήμα διαρκεί δευτερόλεπτα και ρυθμίζει το περιβάλλον για τα code samples που ακολουθούν.

Ρύθμιση της Βασικής σας URL

Κατευθύνετε τον πελάτη SDK σας στο endpoint μας για πρόσβαση στο μοντέλο χωρίς λογοκρισία. Το βασικό URL είναι HTTPS://api.apicharacter.com/v1. Αυτό αντικαθιστά το προεπιλεγμένο URL OpenAI στις ρυθμίσεις σας.

Χωρίς αυτή την αλλαγή, τα αιτήματα θα αποτύχουν ή θα χτυπήσουν τη λάθος υπηρεσία. Χρειάζεται να ορίσετε αυτό μόνο μία φορά όταν αρχικοποιείτε την έκδοση του πελάτη (client instance).

Ορισμός του API Key σας

Εγχύστε το key σας στη μεταβλητή περιβάλλοντος ή στη διαμόρφωση πελάτη. Απαιτείται πιστοποίηση για κάθε αίτηση για την παρακολούθηση της χρήσης του προπληρωμένου credit σας. Το key σας παρέχει πρόσβαση στο uncensored LLM endpoint.

Διατηρήστε αυτή την τιμή ασφαλές. Λειτουργεί ως το μοναδικό διαπιστευτήριο για τον λογαριασμό. Δεν απαιτείται αριθμός τηλεφώνου ή επιπλέον επαλήθευση για βασική πρόσβαση.

Κάντε την πρώτη σας αίτηση

Στείλτε μια απλή ολοκλήρωση συνομιλίας για να επαληθεύσετε τη σύνδεση. Το ID του μοντέλου είναι "uncensored". Αυτό επιβεβαιώνει ότι η πιστοποίησή σας και η base URL είναι σωστές πριν χτίσετε την εφαρμογή σας.

Δείτε το παράδειγμα παρακάτω για μια τυπική εντολή cURL.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Διαχείριση Αποκρίσεων Streaming

Ενεργοποιήστε τη ροή (streaming) για χαμηλότερη καθυστέρηση στις διεπαφές συνομιλίας σας. Ορίστε την παράμετρο stream σε true στο αίτημά σας. Το SDK θα αποδώσει tokens καθώς παράγονται.

Αυτό είναι κρίσιμο για ανταποκρινόμενες εμπειρίες χρήστη. Διαχειρίζεστε τα μερικά κομμάτια καθώς φτάνουν μέσω Server-Sent Events.

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

Κατανοήστε τους περιορισμούς σας για να αποφύγετε διακοπές υπηρεσίας. Έχετε παράθυρο συνάφειας 100,000 tokens. Μέγιστη έξοδος 16,000 tokens εκτός αν ορίσετε διαφορετικά.

Ο περιορισμός ρυθμού είναι 300 αιτήματα ανά λεπτό. Σφάλμα 401 σημαίνει μη έγκυρο κλειδί. Σφάλμα 402 σημαίνει μηδενικό υπόλοιπο. Σφάλμα 429 σημαίνει ότι εξαντλήσατε τον περιορισμό ρυθμού. Λάβετε τα υπόψη σας για την κλιμάκωση σε παραγωγικό περιβάλλον.

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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