Gemma api key documentation

Authentication and Base URL

Χρησιμοποιήστε το μοναδικό κλειδί API σας για να πιστοποιήσετε κάθε αίτηση. Η βάση URL είναι HTTPS://api.gemmaapikey.com/v1 και στέλνετε το κλειδί στο header Authorization. Αυτό λειτουργεί με οποιοδήποτε OpenAI-compatible client αλλάζοντας base_url και το κλειδί API. Αν το χάσετε, δημιουργήστε ένα νέο από το dashboard. Το παλιό κλειδί παύει να λειτουργεί αμέσως. Τα σφάλματα και οι απορρίψεις δεν καταναλώνουν το προπληρωμένο υπόλοιπό σας.

Πρώτη αίτηση

Στείλτε μια αίτηση POST στο /v1/chat/completions με το model id "uncensored". Συμπεριλάβετε το system prompt και το μήνυμα του χρήστη στην παράμετρο messages. Το μοντέλο απαντά με κείμενο που δημιουργήθηκε χωρίς απορρίψεις περιεχομένου για νόμιμη χρήση ενηλίκων.

Copyfrom openai import OpenAI

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

Ορίστε temperature και top_p για τον έλεγχο της τυχαιότητας. Χρησιμοποιήστε ακολουθίες stop για τερματισμό νωρίς της δημιουργίας. Η απόκριση περιλαμβάνει χρήση tokens στο τελευταίο chunk αν είναι ενεργοποιημένο το streaming.

Node SDK Integration

Εγκαταστήστε το επίσημο SDK της OpenAI για Node.js. Διαμορφώστε το με το API key και τη βάση URL από αυτόν τον οδηγό. Καλέστε τη μέθοδο chat.completions.create με το prompt σας.

Copyimport OpenAI from "openai";

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

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

Streaming Αποκρίσεις

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

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)

Η ροή δεδομένων (streaming) μειώνει την αντιλαμβανόμενη καθυστέρηση για μακροχρόνιες απαντήσεις. Επιτρέπει επίσης να εμφανίζετε πρόοδο στους χρήστες σε πραγματικό χρόνο. Το παράθυρο συμφραζομένων υποστηρίζει 100,000 tokens για prompt και ολοκλήρωση συνολικά.

Όρια Ρυθμού και Πλαίσιο

Είστε περιορισμένοι σε 300 αιτήσεις ανά λεπτό ανά κλειδί. Μόνο 8 αιτήσεις μπορούν να εκτελεθούν ταυτόχρονα. Το σώμα της αίτησης δεν πρέπει να υπερβαίνει τα 8 MB. Αυτά τα όρια διασφαλίζουν σταθερή απόδοση για όλους τους χρήστες.

Το μοντέλο υποστηρίζει κλήση συναρτήσεων, λειτουργία JSON και τυπικές παραμέτρους όπως seed και presence_penalty. Η μέγιστη έξοδος είναι 16,000 tokens ανά αίτηση. Αν δεν ορίσετε max_tokens, η προεπιλογή είναι 2,048.

Σφάλματα και Αντιμετώπιση Προβλημάτων

Ένα σφάλμα 401 σημαίνει ότι το API key σας είναι μη έγκυρο ή ληγμένο. Ελέγξτε το dashboard για το ενεργό σας key. Ένα σφάλμα 402 υποδεικνύει ανεπαρκές προκαταβλημένο υπόλοιπο. Προσθέστε κεφάλαιο μέσω κρυπτονομισμάτων για να συνεχίσετε. Ένα σφάλμα 429 σημαίνει ότι έχετε χτυπήσει το όριο ταχύτητας. Περιμένετε λίγα δευτερόλεπτα και δοκιμάστε ξανά.

Τα σφάλματα δεν καταναλώνουν το πιστωτικό σας υπόλοιπο. Αν υπάρχει διπλή χρέωση, χρησιμοποιήστε τη σελίδα Υποστήριξης για να το διορθώσετε. Το πιστωτικό υπόλοιπο δεν λήγει ποτέ, οπότε μπορείτε να το пополните αργότερα.

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'