Τεκμηρίωση API για προγραμματιστές

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

Η βασική διεύθυνση URL είναι HTTPS://api.ollamaapiurl.com/v1. Κάνετε έλεγχο ταυτότητας περνώντας το μοναδικό σας κλειδί API στον header Authorization. Αυτό το κλειδί λειτουργεί ως διαπιστευτήριο για όλες τις αιτήσεις. Αποκτήστε το από το dashboard σας αμέσως μετά την εγγραφή.

• Κρατήστε το κλειδί σας ασφαλές. Παρέχει πλήρη πρόσβαση στο προκαταβλημένο credit σας.
• Δημιουργήστε ένα νέο κλειδί οποιαδήποτε στιγμή από τη σελίδα ρυθμίσεων.

Το σύστημα API key μας είναι απλό. Ένα ενεργό key ανά λογαριασμό διασφαλίζει καθαρή παρακολούθηση. Αν χάσετε την πρόσβαση, αναγεννήστε το ακαριαία. Δεν απαιτείται επαλήθευση μέσω κινητού για να μπλοκαριστεί η είσοδός σας.

Πρώτη αίτηση

Στείλτε το πρώτο prompt χρησιμοποιώντας τυπικό HTTP. Το endpoint δέχεται είσοδο κειμένου και επιστρέφει έξοδο κειμένου. Αυτή η μέθοδος λειτουργεί με οποιαδήποτε βιβλιοθήκη HTTP client προτιμάτε.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

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

Ενσωμάτωση SDK Python

Χρησιμοποιήστε την επίσημη βιβλιοθήκη Python της OpenAI. Σημειώστε τη βάση URL μας. Ορίστε το model id σε uncensored. Αυτό διασφαλίζει ότι θα λάβετε τη συμπεριφορά uncensored χωρίς τα κόστη τοπικής εγκατάστασης.

Copyfrom openai import OpenAI

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

Η βιβλιοθήκη χειρίζεται τις επαναπροσπάθειες και τη μορφοποίηση. Λαμβάνετε δομημένο JSON ή raw κείμενο. Υποστηρίζεται επίσης streaming. Αυτή η προσέγγιση διατηρεί τον κώδικά σας καθαρό και συντηρήσιμο.

Node SDK setup

Εγκαταστήστε το πακέτο openai. Ρυθμίστε το base URL να δείχνει στην υπηρεσία μας. Ορίστε το API key από το περιβάλλον σας. Αυτή η ρύθμιση μιμείται στενά τη διαμόρφωση Python.

Copyimport OpenAI from "openai";

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

Node developers get consistent behavior. The model responds to prompts instantly. You can integrate this into any web server or background worker. No complex routing logic needed.

Απαντήσεις ροής δεδομένων

Ενεργοποιήστε τη ροή (streaming) ορίζοντας stream σε true. Η API επιστρέφει chunks καθώς παράγονται. Αυτό βελτιώνει την αντιλαμβανόμενη καθυστέρηση για τους χρήστες. Μπορείτε να εμφανίσετε tokens καθώς εμφανίζονται.

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)

Το τελικό chunk περιέχει το συνολικό μετρητή tokens. Χρησιμοποιήστε το για επαλήθευση χρέωσης. Το streaming λειτουργεί με όλες τις παραμέτρους. Υποστηρίζει επίσης function calls. Οι χρήστες σας βλέπουν πρόοδο σε πραγματικό χρόνο.

Όρια, σφάλματα και context

Το παράθυρο πλαισίου (context window) καλύπτει 100.000 tokens συνολικά. Αυτό περιλαμβάνει τόσο το prompt όσο και το completion. Μπορείτε να εξάγετε έως 16.000 tokens ανά αίτημα. Το όριο ρυθμού επιτρέπει 300 αιτήματα ανά λεπτό. Οι ταυτόχρονες αιτήσεις περιορίζονται σε οκτώ ανά κλειδί.

Συνηθισμένα σφάλματα περιλαμβάνουν 401 για μη έγκυρα κλειδιά. Ένα σφάλμα 402 σημαίνει ότι το προκαταβλημένο credit σας εξαντλήθηκε. Μια απόκριση 429 σηματοδοτεί ότι φτάσατε στο όριο ρυθμού. Ελέγξτε το dashboard για να προσθέσετε credit μέσω κρυπτονομισμάτων. Τα credits δεν λήγουν ποτέ. Λάθη όπως οι διπλές χρεώσεις διορθώνονται μέσω υποστήριξης.