API Τεκμηρίωση

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

Το API βρίσκεται στο https://api.ollamaapidoc.com/v1. Κάνετε έλεγχο ταυτότητας χρησιμοποιώντας ένα Bearer token στο Authorization header. Δημιουργήστε το κλειδί σας αμέσως μέσω Google ή email στο dashboard. Δεν απαιτείται αριθμός τηλεφώνου. Το κλειδί λειτουργεί με τυπικά SDKs OpenAI ρυθμίζοντας το base URL.

Η πρώτη σας αίτηση

Στείλτε ένα POST request στο /v1/chat/completions με το μοναδικό αναγνωριστικό μοντέλου uncensored. Αυτό το endpoint διαχειρίζεται text input και text output. Υποστηρίζει streaming, JSON mode, και function calling. Μπορείτε να δοκιμάσετε τη σύνδεση χωρίς να ξοδέψετε credit ελέγχοντας πρώτα το models endpoint.

Copycurl https://api.ollamaapidoc.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all installed models"}]
  }'

Η απάντηση επιστρέφει τυπική μορφοποίηση OpenAI. Τα σφάλματα επιστρέφουν τους κατάλληλους κωδικούς HTTP. Ελέγξτε το body για error details if something fails. Streaming responses use Server-Sent Events.

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

Εγκαταστήστε το επίσημο βιβλιοθήκη OpenAI. Διαμορφώστε τον πελάτη με τη βάση URL και το API key. Καλέστε το endpoint chat completions. Ο κώδικας παραμένει ταυτόσημος με την τυπική χρήση OpenAI. Αυτό διασφαλίζει εύκολη μετοίκιση για υπάρχοντα έργα. Μπορείτε να προσαρμόσετε παραμέτρους όπως θερμοκρασία και top_p απευθείας στην κλήση.

Copyfrom openai import OpenAI

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

Διαχειριστείτε εξαιρέσεις για όρια ρυθμού ή μη έγκυρα κλειδιά. Η βιβλιοθήκη ρέει tokens αν ορίσετε stream σε true. Αυτή η προσέγγιση διατηρεί τον κώδικά σας καθαρό και συμβατό.

Ρύθμιση SDK Node.js

Χρησιμοποιήστε το openai πακέτο npm. Αρχικοποιήστε τον πελάτη με το custom base URL. Περνάτε το κλειδί API σας. Η σύνταξη μιμείται το παράδειγμα Python. Αυτή η συνέπεια μειώνει τον χρόνο αποσφαλμάτωσης. Μπορείτε να στείλετε πολλαπλά μηνύματα σε μια σειρά ιστορικού συνομιλίας.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapidoc.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 επιστρέφει δομημένο JSON. Η διαχείριση σφαλμάτων είναι κρίσιμη για εφαρμογές παραγωγής. Πιάστε σφάλματα δικτύου και σφάλματα συγκεκριμένα API ξεχωριστά. Αυτό διασφαλίζει ότι η εφαρμογή σας παραμένει ανταποκρινόμενη κατά τη διάρκεια υψηλής κίνησης.

Ροή και Λειτουργία JSON

Ενεργοποιήστε τη ροή δεδομένων (streaming) ορίζοντας το stream parameter to true. The API sends tokens via Server-Sent Events. You receive partial responses in real-time. This improves user experience for long outputs. You can also enforce JSON output using response_format. Αυτό είναι χρήσιμο για εξαγωγή δομημένων δεδομένων.

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 ανά αίτημα. Τα σφάλματα περιλαμβάνουν 401 για μη έγκυρα κλειδιά και 402 για ανεπαρκές πιστωτικό υπόλοιπο. Τα όρια ρυθμού φτάνουν τα 300 αιτήματα ανά λεπτό. Αντιμετωπίστε τα ευγενικά στην εφαρμογή σας. Το API δεν χρησιμοποιεί ποτέ τις εντολές σας για εκπαίδευση. Η ιδιωτικότητα διατηρείται. Το πιστωτικό υπόλοιπο δεν λήγει.