el ▾
Αποκτήστε το key σας

Ενσωματώστε routerapi σε Λεπτά

Αντικαταστήστε τον υπάρχοντα κώδικα συμβατό με OpenRouter με μία μόνο αλλαγή μεταβλητής. Λάβετε μια διεπαφή χωρίς περιθώρια έτοιμη σε λίγα λεπτά χωρίς να ξαναγράψετε τη λογική της ενσωμάτωσής σας.

Περιεχόμενα

Πιστοποίηση και Ρύθμιση Base URL

Αλλαγή base_url και api_key για να εναλλάξετε παρόχους ακαριαία. Σημειώστε το SDK σας στο HTTPS://api.routerapi.cc/v1 και χρησιμοποιήστε το key που δημιουργήσατε από το dashboard σας. Δεν απαιτούνται σύνθεκτοι κανόνες διαδρομής ή διαμόρφωση πολλαπλών μοντέλων. Οι υπάρχοντες headers και η διαμόρφωση του πελάτη σας παραμένουν ίδιες με το πρότυπο OpenAI.

Το key εμφανίζεται αμέσως μετά την εγγραφή μέσω Google ή email. Αποθηκεύστε το με ασφάλεια και περάστε το ως Bearer token στην κεφαλίδα HTTP Authorization. Αυτή η μοναδική αλλαγή κατευθύνει όλες τις αιτήσεις στο μοντέλο uncensored μας χωρίς να τροποποιήσει τον κώδικα της εφαρμογής σας.

Αποστολή Αίτησης Ολοκλήρωσης Συνομιλίας

Στείλτε ένα τυπικό POST αίτηση για /v1/chat/completions για τη δημιουργία κειμένου. Η διεπαφή δέχεται την ίδια δομή JSON που χρησιμοποιεί η OpenAI, διασφαλίζοντας ότι τα prompts σας λειτουργούν χωρίς τροποποίηση. Χρησιμοποιήστε το ID μοντέλου uncensored για πρόσβαση στο μοντέλο γλώσσας μεγάλου μεγέθους μας, ρυθμισμένο για μη περιορισμένες απαντήσεις.

Κάθε αίτημα καταναλώνει tokens από το προπληρωμένο σας υπόλοιπο. Τα σφάλματα και οι απορρίψεις δεν χρεώνουν το υπόλοιπό σας, οπότε μπορείτε να δοκιμάζετε ελεύθερα. Το παρακάτω παράδειγμα δείχνει μια βασική κλήση δημιουργίας κειμένου χρησιμοποιώντας το επίσημο SDK.

curl https://api.routerapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
  }'

Η απάντηση επιστρέφει το παραγόμενο κείμενο στο choices[0].message.content πεδίο. Μπορείτε να προσαρμόσετε παραμέτρους όπως temperature ή top_p για τον έλεγχο της δημιουργικότητας. Δεν διατίθενται endpoints για embeddings ή δημιουργία εικόνων· η υπηρεσία εστιάζει αυστηρά στην ολοκλήρωση κειμένου.

Διαχείριση Streaming Αποκρίσεων (SSE)

Ενεργοποιήστε streaming ρυθμίζοντας stream: true στο σώμα του αιτήματός σας. Το API επιστρέφει Server-Sent Events (SSE) για παράδοση tokens σε πραγματικό χρόνο. Αυτό μειώνει την αντιλαμβανόμενη καθυστέρηση για διεπαφές συνομιλίας και εφαρμογές roleplay. Κάθε τμήμα περιέχει ένα μερικό delta της απάντησης.

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)

Το τελευταίο chunk περιλαμβάνει τα πλήρη στατιστικά χρήσης tokens για το αίτημα. Ερμηνεύστε το content field από κάθε delta για να ανακατασκευάσετε το πλήρες μήνυμα. Αυτή η προσέγγιση διατηρεί το UI σας αντιδραστικό ενώ το μοντέλο επεξεργάζεται μακροσκελή πλαίσια. Οι μετρήσεις tokens στο τελικό chunk αντικατοπτρίζουν τόσο τη χρήση εισόδου όσο και εξόδου.

Χρησιμοποιώντας Tools και Function Calling

Περάστε ορισμούς εργαλείων στο tools παράμετρος για τη δυνατότητα κλήσης συναρτήσεων. Το μοντέλο επιστρέφει δομημένες κλήσεις εργαλείων στην απόκριση αντί για απλό κείμενο. Προσδιορίστε tool_choice να αναγκάσει το μοντέλο να χρησιμοποιήσει μια συγκεκριμένη συνάρτηση ή να κάνει αυτοματική επιλογή. Αυτή η λειτουργία λειτουργεί ακριβώς όπως η κλήση συναρτήσεων της OpenAI.

from openai import OpenAI

client = OpenAI(base_url="https://api.routerapi.cc/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 schemas και δώστε τις στο αίτημα. Το API διαχειρίζεται την ανακατεύθυνση μεταξύ δημιουργίας κειμένου και κλήσης εργαλείου. Χρησιμοποιήστε το response_format parameter with {"type": "json_object"} για αυστηρή έξοδο JSON όταν δεν απαιτούνται εργαλεία. Αυτό διασφαλίζει συνεπή δομημένα δεδομένα για τις υπηρεσίες backend σας.

Ρύθμιση JSON Mode για Δομημένη Έξοδο

Εξαναγκάστε το μοντέλο να επιστρέψει έγκυρο JSON ρυθμίζοντας response_format για {"type": "json_object"}. Αυτό είναι απαραίτητο για την ανάλυση δεδομένων σε αυτοματοποιημένες διεργασίες ή AI agents. Το μοντέλο θα προσπαθήσει να κλείσει όλες τις αγκύλες και να ακολουθήσει το ζητούμενο schema. Ενδέχεται να προκύψουν σφάλματα εάν το παραγόμενο κείμενο γίνει πολύ μεγάλο για το παράθυρο συμφραζομένων.

import OpenAI from "openai";

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

Συνδυάστε τη λειτουργία JSON με temperature ορισμένο σε 0 για μέγιστο ντετερμινισμό. Χρησιμοποιήστε αυτό για εξαγωγή οντοτήτων, μορφοποίηση δεδομένων ή δημιουργία αρχείων διαμόρφωσης. Το μοντέλο uncenames χειρίζεται καλά σύνθετες εσωτερικές δομές. Πάντα να επαληθεύετε την έξοδο στον κώδικά σας πριν την επεξεργασία.

Κατανόηση Ορίων Tokens και Κόστους

Το παράθυρο συμφραζομένων υποστηρίζει 100,000 tokens για prompt και completion συνολικά. Κάθε αίτημα μπορεί να εξάγει έως 16,000 tokens, ή 2,048 αν max_tokens είναι μη ρυθμισμένο. Η τιμολόγηση είναι $0.15 ανά εκατομμύριο input tokens και $0.50 ανά εκατομμύριο output tokens. Το πιστωτικό υπόλοιπο δεν λήγει ποτέ και τα σφάλματα είναι δωρεάν.

Παρακολουθήστε τη χρήση σας μέσω του πίνακα ελέγχου ή των headers απόκρισης. Τα αιτήματα περιορίζονται σε μέγεθος σώματος 8 MB. Μπορείτε να προσθέσετε κεφάλαια με USDT (TRC20) ή USDC (Base) ξεκινώντας από $20. Τα bonus πιστωτικά μονάδα αυξάνονται με μεγαλύτερες καταθέσεις: +5% στα $50, +10% στα $100, και +15% στα $200. Δεν ισχύουν χρεώσεις συνδρομής.

Frequently asked questions

Πώς διαχειρίζομαι όρια συχνότητας και σφάλματα;

Η API επιβάλλει όριο 300 αιτήσεων ανά λεπτό και 8 ταυτόχρονες αιτήσεις ανά key. Ο κωδικός κατάστασης 429 υποδηλώνει ότι έχετε υπερβεί αυτά τα όρια· περιμένετε λίγα δευτερόλεπτα πριν κάνετε επανάληψη. Σφάλμα 401 σημαίνει ότι το API key σας είναι άκυρο, και σφάλμα 402 υποδηλώνει ανεπαρκές προκαταβλημένο υπόλοιπο. Ελέγξτε το σώμα του μηνύματος σφάλματος για λεπτομέρειες σχετικά με το ποιο όριο ενεργοποιήθηκε.

Είναι το routerapi κατάλληλο για χρήση παραγωγής υψηλού όγκου;

Ναι, η υπηρεσία υποστηρίζει ταυτόχρονες αιτήσεις και streaming για εφαρμογές χαμηλής καθυστέρησης. Ωστόσο, δεν προσφέρει εγγυήσεις SLA και προηγμένες λειτουργίες όπως embeddings. Χρησιμοποιήστε το για chat, roleplay ή δημιουργική γραφή όπου το uncensored output είναι κρίσιμο. Παρακολουθήστε τη χρήση tokens για να διασφαλίσετε ότι το προπληρωμένο υπόλοιπό σας καλύπτει τον όγκο σας.

Τι συμβαίνει στο πιστωτικό μου αν κάνω λάθος;

Το υπόλοιπο είναι προκαταβλεπόμενο και δεν λήγει ποτέ, οπότε τα αχρησιμοποίητα κεφάλαια παραμένουν διαθέσιμα για αόριστο χρονικό διάστημα. Λάθη όπως οι διπλές χρεώσεις επιλύονται μέσω της σελίδας Υποστήριξης. Τα λάθη και οι απορρίψεις δεν καταναλώνουν το υπόλοιπό σας, οπότε η δοκιμή των προτροπών σας είναι δωρεάν. Μπορείτε να συμπληρώσετε ξανά οποιαδήποτε στιγμή χρησιμοποιώντας κρυπτονομίσματα.

Λάβετε το API key σας

Εγγραφείτε, αποκτήστε το κλειδί σας, κατευθυνθείτε στη νέα βάση URL. Έγινε.