Codex API documentation και endpoints

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

Στείλτε αιτήματα στη βάση URL https://api.codexapipricing.com/v1 χρησιμοποιώντας το API key σας. Αυτό το endpoint είναι συμβατό με τα τυπικά SDKs του OpenAI, οπότε χρειάζεται μόνο να ενημερώσετε το base URL και να παρέχετε το key σας. Κάνετε authentication περνώντας το header Authorization: Bearer YOUR_API_KEY με κάθε request. Μπορείτε να δημιουργήσετε ένα key άμεσα συνδεόμενοι με Google ή email και κωδικό. Το key εμφανίζεται μία φορά μετά τη δημιουργία, οπότε αποθηκεύστε το με ασφάλεια. Τα prompts σας δεν χρησιμοποιούνται για εκπαίδευση, διασφαλίζοντας την ιδιωτικότητα των δεδομένων σας.

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

Χρησιμοποιήστε το POST /v1/chat/completions σημείο τερματισμού (endpoint) για παραγωγή κειμένου. Αυτή είναι η κύρια διεπαφή για την αποστολή προτροπών και λήψη απαντήσεων. Το ID του μοντέλου είναι πάντα uncensored, ανεξάρτητα από την έκδοση μοντέλου που τρέχει στους servers μας. Μπορείτε να ελέγξετε τα διαθέσιμα μοντέλα μέσω GET /v1/models. Στείλτε την ιστορία των μηνυμάτων σας στο messages

Υποστηριζόμενες παράμετροι και λειτουργία JSON

Ελέγξτε τη δημιουργία με παραμέτρους όπως temperature, top_p, και stop. Χρησιμοποιήστε response_format ορισμένο σε {"type": "json_object"} για να επιβληθεί έξοδος JSON. Αυτό είναι χρήσιμο για εξαγωγή δομημένων δεδομένων ή κλήση συναρτήσεων. Μπορείτε επίσης να ορίσετε max_tokens για να περιορίσετε το μήκος της εξόδου, με προεπιλογή 2.048 αν παραληφθεί. Το παράθυρο συμφραζομένων υποστηρίζει έως 100.000 tokens για prompt και συμπλήρωση συνολικά. Δώστε seed για ντετερμινιστικά αποτελέσματα ή presence_penalty και frequency_penalty για προσαρμογή της επανάληψης. Αυτές οι παράμετροι επιτρέπουν τη λεπτομερή ρύθμιση της συμπεριφοράς του μοντέλου χωρίς πολύπλοκη διαμόρφωση. Η λειτουργία JSON διασφαλίζει αυστητή μορφοποίηση για αξιόπιστη ανάλυση στην εφαρμογή σας.

Οι ροές απαντήσεων μέσω SSE

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Το API επιστρέφει Server-Sent Events (SSE) καθώς παράγονται tokens. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μεγάλες απαντήσεις. Τα στοιχεία χρήσης tokens εμφανίζονται στο τελευταίο chunk της ροής. Μπορείτε να επεξεργαστείτε τα tokens_incrementally για να εμφανίσετε κείμενο σε πραγματικό χρόνο. Αυτή η λειτουργία λειτουργεί με όλα τα OpenAI-compatible SDKs. Η ροή (streaming) είναι ιδανική για διεπαφές συνομιλίας όπου οι χρήστες αναμένουν άμεση ανατροφοδότηση. Το τελευταίο chunk περιέχει τη συνολική μέτρηση tokens για ακρίβεια στη χρέωση. Χρησιμοποιήστε αυτή τη μέθοδο για να διαχειριστείτε ομαλά μεγάλα αποτελέσματα χωρίς να περιμένετε την πλήρη απάντηση.

Όρια ρυθμού και σώματα αιτήσεων

Κάθε κλειδί API περιορίζεται σε 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες συνδέσεις. Το μέγιστο μέγεθος του σώματος αιτήματος είναι 8 MB. Αν ξεπεράσετε αυτά τα όρια, λαμβάνετε σφάλμα 429. Μπορείτε να δημιουργήσετε νέα κλειδιά για να αντικαταστήσετε τα υπάρχοντα, αλλά μόνο ένα κλειδί είναι ενεργό ανά λογαριασμό. Τα σφάλματα και οι απορρίψεις δεν μετράνε στο όριο ρυθμού σας. Το παράθυρο πλαισίου 100.000 tokens επιτρέπει εκτεταμένη ιστορία συνομιλιών. Κρατήστε τα σώματα αιτημάτων σας συνοπτικά για να μείνετε εντός των ορίων μεγέθους. Παρακολουθήστε τη χρήση σας για να αποφύγετε διακοπές κατά τις ώρες αιχμής. Αυτά τα όρια διασφαλίζουν δίκαιη χρήση για όλους τους πελάτες με προκαταβλημένα χρήματα.

Χειρισμός σφαλμάτων και αντιμετώπιση προβλημάτων

Διαχειριστείτε τα σφάλματα ελέγχοντας τον κωδικό κατάστασης HTTP. Το σφάλμα 401 υποδηλώνει μη έγκυρο ή λείπον κλειδί API. Το σφάλμα 402 σημαίνει ότι το προκαταβλημένο πιστωτικό σας υπόλοιπο εξαντλήθηκε. Το σφάλμα 429 σηματοδοτεί ότι έχετε ξεπεράσει τα όρια ρυθμού. Χρησιμοποιήστε το error field στην απάντηση για να λάβετε λεπτομέρειες. Λάθη όπως οι διπλές χρεώσεις διορθώνονται μέσω της σελίδας Υποστήριξης. Το υπόλοιπο δεν λήγει ποτέ, οπότε μπορείτε να κάνετε επαναφόρτιση αργότερα. Οι απορρίψεις για παραβιάσεις πολιτικής περιεχομένου είναι δωρεάν. Αυτή η προβλέψιμη δομή σφάλματος σας βοηθά να αποσφαλματώσετε γρήγορα θέματα ενσωμάτωσης χωρίς να μαντεύετε την αιτία.

cURL

Copycurl https://api.codexapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the hourly rates for the large model."}]
  }'

Python

Copyfrom openai import OpenAI

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