Authentication and Base URL
Χρήση https://api.ollamaendpointurl.com/v1 ως τη βάση URL σας και συμπεριλάβετε το κλειδί API σας στο Authorization header.
- Βασικό URL:
https://api.ollamaendpointurl.com/v1 - Header:
Authorization: Bearer YOUR_API_KEY
Δημιουργήστε το key σας άμεσα μέσω Google ή email στο dashboard. Δεν απαιτείται αριθμός τηλεφώνου. Αυτό το URL λειτουργεί με οποιοδήποτε τυπικό OpenAI SDK υπερκαθορίζοντας το base URL.
Πρώτη αίτηση
Στείλτε ένα POST request στο /v1/chat/completions με το μοναδικό αναγνωριστικό μοντέλου uncensored και τα μηνύματά σας.
curl https://api.ollamaendpointurl.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the default port for Ollama?"}]
}'Αυτό επιστρέφει μια απάντηση JSON που περιέχει το παραγόμενο κείμενο. Αν λάβετε σφάλμα 401, το κλειδί API σας είναι άκυρο. Ένα σφάλμα 402 υποδηλώνει ανεπαρκές προκαταβλημένο υπόλοιπο.
Ενσωμάτωση SDK Python
Προσδιορίστε τον πελάτη με το key σας και το προσαρμοσμένο base URL για να στέλνετε αιτήσεις προγραμματιστικά.
from openai import OpenAI
client = OpenAI(base_url="https://api.ollamaendpointurl.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. Το μοντέλο δέχεται τυπικές παραμέτρους όπως temperature και top_p για ρύθμιση της συμπεριφοράς παραγωγής.
Node SDK Integration
Ρυθμίστε τον πελάτη Node.js για να δείχνει στο endpoint μας για άψογη ενσωμάτωση στα scripts σας.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ollamaendpointurl.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);Το SDK διαχειρίζεται αυτόματα τη σειριοποίηση. Βεβαιωθείτε ότι χρησιμοποιείτε μια πρόσφατη έκδοση του OpenAI SDK που υποστηρίζει custom base URLs. Τα σφάλματα εκτοξεύονται ως τυπικά σφάλματα API.
Streaming Αποκρίσεις
Ενεργοποιήστε streaming ρυθμίζοντας stream: true για να λαμβάνετε tokens μέσω Server-Sent Events (SSE).
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)Τα λεπτομερή δεδομένα χρήσης token εμφανίζονται στο τελευταίο chunk της ροής. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για μακροσκελείς εξόδους. Το endpoint υποστηρίζει τυπική μορφοποίηση SSE συμβατή με τις περισσότερες βιβλιοθήκες πελατών.
Όρια Ρυθμού και Πλαίσιο Συγκειμένου
Κάθε κλειδί API περιορίζεται σε 300 αιτήματα ανά λεπτό και 8 ταυτόχρονες συνδέσεις. Το παράθυρο πλαισίου είναι 100.000 tokens συνολικά. Η μέγιστη έξοδος ανά αίτημα είναι 16.000 tokens. Αιτήματα με σώμα μεγαλύτερο από 8 MB απορρίπτονται. Το σφάλμα 429 υποδεικνύει ότι έχετε χτυπήσει το όριο ρυθμού. Περιμένετε λίγο πριν κάνετε επανάληψη. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν υπόλοιπο. Τα χρήματα δεν λήγουν ποτέ. Χρησιμοποιήστε κρυπτονομίσματα για ανεφοδιασμό. Ξεκινήστε με δοκιμαστικό υπόλοιπο $0.50. Αποκτήστε το κλειδί σας τώρα.
