Γρήγορη Έναρξη: API Ολοκληρώσεων Συζήτησης

Προαπαιτούμενα και base URL

Η API μας είναι πλήρως συμβατή με το πρότυπο ολοκληρώσεων συνομιλίας OpenAI. Χρειάζεστε μόνο μια βάση URL και ένα κλειδί API για να ξεκινήσετε να στέλνετε αιτήματα. Η βάση URL είναι HTTPS://api.howmuchisanapikey.com/v1. Αυτό το μοναδικό endpoint διαχειρίζεται όλη τη δημιουργία κειμένου χωρίς να απαιτείται να διαχειριστείτε πολλαπλές διευθύνσεις υπηρεσιών ή διαμορφώσεις proxy.

Η πιστοποίηση είναι απλή. Πρέπει να συμπεριλάβετε κεφαλίδα Authorization με το σχήμα Bearer ακολουθούμενο από το μοναδικό σας κλειδί. Κάθε αίτημα στο endpoint ολοκλήρωσης συνομιλίας απαιτεί αυτή την κεφαλίδα για την επαλήθευση του λογαριασμού σας και την παρακολούθηση της χρήσης tokens έναντι του προπληρωμένου υπολοίπου πιστωτικών.

Πιστοποίηση και headers

Συμπεριλάβετε τον header Authorization σε κάθε αίτημα για να επαληθεύσετε ταυτότητα. Η μορφή header είναι Authorization: Bearer YOUR_API_KEY. Αν το key είναι άκυρο ή ληγμένο, το API επιστρέφει σφάλμα 401 αμέσως. Αυτό διασφαλίζει ότι μόνο εξουσιοδοτημένοι λογαριασμοί μπορούν να καταναλώσουν το προπληρωμένο credit σας.

Δεν χρειάζεται να περάσετε επιπλέον τίτλους για βασική παραγωγή κειμένου. Ωστόσο, αν χρησιμοποιείτε συγκεκριμένες λειτουργίες όπως JSON mode ή function calling, πρέπει να ορίσετε τον τίτλο Content-Type σε application/json. Αυτό λέει στον server πώς να αναλύσει σωστά το σώμα της αίτησής σας.

Αποστολή της πρώτης σας ολοκλήρωσης συνομιλίας

Στείλτε μια αίτηση POST στο /v1/chat/completions με την ιστορία των μηνυμάτων σας και το αναγνωριστικό μοντέλου. Το model id είναι "uncensored". Αυτό το μοντέλο είναι βελτιστοποιημένο για απάντηση χωρίς απορρίψεις για νόμιμο περιεχόμενο ενηλίκων, φαντασία ή αμφιλεγόμενα θέματα. Δεν φιλτράρει με βάση τα τυπικά πολιτικά ή κοινωνικά πρότυπα.

Ακολουθεί ένα βασικό παράδειγμα curl για να ξεκινήσετε:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Η απάντηση θα περιέχει το παραγόμενο κείμενο στην array choices. Μπορείτε να το αναλύσετε απευθείας στη λογική της εφαρμογής σας. Κάθε αίτηση καταναλώνει tokens εισόδου για το prompt σας και tokens εξόδου για την απάντηση του μοντέλου.

Οι ροές απαντήσεων (streaming) και η χρήση token

Χρησιμοποιήστε Server-Sent Events (SSE) για να λάβετε tokens καθώς παράγονται. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μακρές εξόδους. Ορίστε την παράμετρο stream σε true στο σώμα του αιτήματός σας. Ο διακομιστής θα στείλει πολλά chunks, το καθένα περιέχοντας ένα μερικό delta της απάντησης.

Το τελευταίο chunk περιλαμβάνει τα δεδομένα χρήσης. Αυτό το αντικείμενο περιέχει τη συνολική κατανάλωση tokens εισόδου και εξόδου από το αίτημα. Μπορείτε να χρησιμοποιήσετε αυτά τα δεδομένα για να ενημερώσετε το τοπικό σας πιστωτικό υπόλοιπο ή να παρακολουθήσετε τις δαπάνες σας σε πραγματικό χρόνο. Το streaming είναι ιδανικό για διεπαφές συνομιλίας όπου οι χρήστες αναμένουν άμεση ανατροφοδότηση.

Κλήση συναρτήσεων και λειτουργία JSON

Η API υποστηρίζει δομημένες εξόδους μέσω JSON mode και function calling. Ορίστε response_format σε {"type": "json_object"} για να αναγκάσετε το μοντέλο να επιστρέψει έγκυρο JSON. Αυτό είναι χρήσιμο για την εξαγωγή δεδομένων ή τη δημιουργία δομημένων ρυθμίσεων χωρίς σφάλματα ανάλυσης.

Για function calling, παρέχετε ένα tools array στο αίτημά σας. Το μοντέλο θα απαντήσει με tool_calls αν καθορίσει ότι χρειάζεται μια συνάρτηση. Στη συνέχεια, μπορείτε να εκτελέσετε τη συνάρτηση και να στείλετε το αποτέλεσμα πίσω στο μοντέλο. Αυτό επιτρέπει πολύπλοκες πολυβηματικές ροές εργασίας χωρίς εξωτερική λογική ανάλυσης.

Διαχείριση ορίων και σφαλμάτων

Είστε περιορισμένοι σε 300 αιτήσεις ανά λεπτό ανά κλειδί και 8 ταυτόχρονες αιτήσεις. Αν τις υπερβείτε, θα λάβετε σφάλμα 429 Too Many Requests. Το σώμα της απόκρισης θα περιλαμβάνει λεπτομέρειες retry-after. Προσαρμόστε τον πλευρικό περιορισμό ρυθμού του client για να αποφύγετε περιττές επαναλήψεις.

Αν το προκαταβλημένο υπόλοιπό σας εξαντληθεί, το API επιστρέφει σφάλμα 402 Payment Required. Μπορείτε να αναπληρώσετε μέσω crypto οποιαδήποτε στιγμή. Τα σφάλματα και οι απορρίψεις είναι δωρεάν, οπότε πληρώνετε μόνο για την επιτυχημένη δημιουργία tokens. Το παράθυρο πλαισίου είναι 100,000 tokens για prompt και completion συνδυαστικά.

Python

Copyfrom openai import OpenAI

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

Ροή

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)