Documentație cheie API Gemma

Autentificare și URL de bază

Folosește cheia ta unică API pentru a autentifica fiecare solicitare. URL-ul de bază este HTTPS://api.gemmaapikey.com/v1 și trimiți cheia în antetul Authorization. Acest lucru funcționează cu orice client compatibil OpenAI schimbând base_url și cheia API. Dacă o pierzi, generează una nouă din panoul de control. Cheia veche încetează să mai funcționeze imediat. Erorile și refuzurile nu consumă creditul tău preplătit.

Prima cerere

Trimiteți o cerere POST către /v1/chat/completions cu id-ul modelului "uncensored". Include promptul de sistem și mesajul utilizatorului în array-ul messages. Modelul răspunde cu text generat fără refuzuri de conținut pentru uz adult legal.

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)

Setează temperature și top_p pentru a controla aleatorietatea. Folosește secvențe stop pentru a opri generarea devreme. Răspunsul include utilizarea tokenilor în ultimul chunk dacă streaming-ul este activat.

Integrare SDK Node

Instalează SDK-ul oficial OpenAI pentru Node.js. Configurează-l cu cheia ta API și URL-ul de bază din acest ghid.apelează metoda chat.completions.create cu promptul tău.

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);

Această abordare menține costurile predictibile deoarece plătești doar pentru tokenii utilizați. Credital preplătit este debitat în funcție de utilizarea reală. Nu se aplică taxe lunare. Poți alimenta contul cu criptomonede în orice moment.

Răspunsuri în streaming

Activați streaming-ul setând stream la true în cerere. API-ul returnează fragmente Evenimente trimise de server (SSE). Fiecare fragment conține text parțial până când ultimul fragment include utilizarea tokenilor.

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-ul reduce latența percepută pentru răspunsurile lungi. De asemenea, îți permite să afișezi progresul utilizatorilor în timp real. Fereastra de context suportă 100,000 de tokeni pentru prompt și completare împreună.

Limite de rată și context

Ești limitat la 300 de cereri pe minut per cheie. Doar 8 cereri pot rula simultan. Corpul cererii nu trebuie să depășească 8 MB. Aceste limite asigură o performanță stabilă pentru toți utilizatorii.

Modelul suportă apelarea de funcții, modul JSON și parametrii standard precum seed și presence_penalty. Output-ul maxim este de 16.000 de tokeni per solicitare. Dacă nu setați max_tokens, se utilizează valoarea implicită de 2.048.

Erori și Depanare

Eroarea 401 înseamnă că cheia ta API este invalidă sau expirată. Verifică panoul de control pentru cheia ta activă. O eroare 402 indică credit preplătit insuficient. Reîncarcă prin criptomonede pentru a continua. O eroare 429 înseamnă că ai atins limita de rată. Așteaptă câteva secunde și încearcă din nou.

Erorile nu consumă creditul tău. Dacă ai o dublă taxare, folosește pagina de Suport pentru a o remedia. Creditul nu expiră niciodată, așa că poți reîncărca mai târziu.

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"}]
  }'