Πιστοποίηση και API Keys
Ξεκινήστε δημιουργώντας έναν λογαριασμό για να λάβετε το API key σας άμεσα. Μπορείτε να εγγραφείτε χρησιμοποιώντας το Google ή ένα email με κωδικό, χωρίς να χρειάζεται αριθμός τηλεφώνου. Το σύστημα δημιουργεί ένα ενεργό κλειδί ανά λογαριασμό και η δημιουργία νέου κλειδιού αντικαθιστά το παλιό άμεσα. Χρειάζεστε μόνο μια διεύθυνση email για να ξεκινήσετε και τα prompts σας δεν χρησιμοποιούνται για εκπαίδευση. Χρησιμοποιήστε αυτό το κλειδί στο Authorization header ως bearer token για όλες τις αιτήσεις.
Πρώτη αίτηση
Κάντε την πρώτη σας κλήση στο endpoint chat completions χρησιμοποιώντας το API key σας. Το base URL είναι https://api.aidphn.com/v1 και λειτουργεί με τυπικούς πελάτες συμβατούς με OpenAI. Πρέπει να καθορίσετε το μοντέλο uncensored για πρόσβαση στο μοντέλο γλώσσας μεγάλου μεγέθους χωρίς φίλτρα. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν τα προκαταβλεπόμενα πιστωτικά σας, οπότε μπορείτε να δοκιμάσετε με ασφάλεια.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'Επαληθεύστε ότι το key λειτουργεί ελέγχοντας το endpoint λίστας μοντέλων. Αυτό επιβεβαιώνει τη συνδεσιμότητα πριν στείλετε σύνθετα prompts. Το API δέχεται κείμενο ως είσοδο και επιστρέφει κείμενο ως έξοδο, υποστηρίζοντας πρότυπες παραμέτρους όπως temperature και top_p.
Ενσωμάτωση SDK Python
Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI για να αλληλεπιδράσετε με το endpoint μας. Ορίστε τη βάση URL στον server του API μας και παρέχετε το key σας. Αυτή η προσέγγιση σας επιτρέπει να επαναχρησιμοποιήσετε υπάρχοντα κώδικα από projects OpenAI χωρίς μεγάλες αλλαγές. Το ID του μοντέλου παραμένει uncensored για όλες τις ολοκληρώσεις.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)Μπορείτε να ρυθμίσετε παραμέτρους όπως max_tokens για τον έλεγχο του μήκους εξόδου. Η προεπιλεγμένη μέγιστη έξοδος είναι 2.048 tokens, αλλά μπορείτε να την αυξήσετε έως 16.000 ανά αίτηση. Η ροή (streaming) είναι διαθέσιμη για μακρές απαντήσεις για τη μείωση της καθυστέρησης.
Node SDK Usage
Ενσωματώστε το API στις εφαρμογές Node.js σας χρησιμοποιώντας το τυπικό SDK. Ορίστε τη βάση URL του πελάτη στη διεύθυνση URL βάσης μας και αυθεντικοποιηθείτε με το κλειδί σας. Αυτή η μέθοδος υποστηρίζει τόσο συγχρονικές όσο και ασύγχρονες αιτήσεις για ευέλικτη ενσωμάτωση. Μπορείτε να περάσετε εργαλεία για κλήση συναρτήσεων ή να επιβάλετε λειτουργίες εξόδου JSON.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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 υποστηρίζει τυπικές παραμέτρους όπως stop ακολουθίες και seed για αναπαραγωγιμότητα. Η διαχείριση σφαλμάτων πρέπει να λαμβάνει υπόψη τους περιορισμούς ρυθμού και τη διαθεσιμότητα πιστωτικού υπολοίπου.
Streaming Αποκρίσεις μέσω SSE
Ενεργοποιήστε streaming ρυθμίζοντας stream: true στην αίτησή σας. Το API επιστρέφει Server-Sent Events (SSE) για παράδοση tokens σε πραγματικό χρόνο. Κάθε chunk περιέχει μερικό περιεχόμενο, επιτρέποντάς σας να εμφανίσετε το αποτέλεσμα καθώς παράγεται. Το τελευταίο chunk περιλαμβάνει τη συνολική χρήση tokens για διαφάνεια στη χρέωση.
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)Η ροή δεδομένων (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση για χρήστες που περιμένουν μακροχρόνιες απαντήσεις. Μπορείτε να επεξεργαστείτε tokens σταδιακά ή να τα αποθηκεύσετε για μελλοντική χρήση. Το παράθυρο συμφραζομένων υποστηρίζει έως 100,000 tokens για prompt και ολοκλήρωση συνολικά.
Όρια και Σφάλματα
Παρακολουθήστε τη χρήση σας έναντι αυστηρών ορίων ρυθμού και υπολοίπων πιστωτικών. Μπορείτε να στείλετε 300 αιτήματα ανά λεπτό και να έχετε 8 ταυτόχρονες αιτήσεις ανά κλειδί. Το μέγιστο μέγεθος σώματος αιτήματος είναι 8 MB. Σφάλματα όπως 401 υποδεικνύουν ένα άκυρο κλειδί, ενώ το 402 σημαίνει ότι χρειάζεται να προσθέσετε κεφάλαια. Τα σφάλματα 429 σήματος ότι έχετε ξεπεράσει το όριο ρυθμού. Προσθέστε κεφάλαια μόνο με κρυπτονομίσματα, ξεκινώντας από $20, για να συνεχίσετε να χρησιμοποιείτε την υπηρεσία χωρίς διακοπή.
