documentazione chiave api Gemma

Autenticazione e Base URL

Utilizza la tua chiave API unica per autenticare ogni richiesta. L'URL di base è HTTPS://api.gemmaapikey.com/v1 e invii la chiave nell'intestazione Authorization. Questo funziona con qualsiasi client compatibile con OpenAI modificando base_url e la chiave API. Se la perdi, generane una nuova dalla dashboard. La vecchia chiave smette di funzionare immediatamente. Errori e rifiuti non consumano il tuo credito prepagato.

Prima richiesta

Invia una richiesta POST a /v1/chat/completions con l'ID del modello "uncensored". Inserisci il tuo prompt di sistema e il messaggio utente nell'array messages. Il modello risponde con testo generato senza rifiuti di contenuto per l'uso adulto lecito.

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)

Imposta temperature e top_p per controllare la casualità. Usa sequenze stop per interrompere la generazione anticipatamente. La risposta include l'utilizzo dei token nell'ultimo chunk se lo streaming è abilitato.

Integrazione SDK Node

Installa l'SDK ufficiale di OpenAI per Node.js. Configuralo con la tua chiave API e l'URL base indicato in questa guida. Chiama il metodo chat.completions.create con il tuo 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);

Questo approccio mantiene i costi prevedibili perché si paga solo per i token utilizzati. Il credito prepagato viene addebitato in base all'utilizzo effettivo. Non si applicano canoni mensili. Si può ricaricare con criptovalute in qualsiasi momento.

Risposte in streaming

Abilita lo streaming impostando stream su true nella richiesta. L'API restituisce chunk di Server-Sent Events (SSE). Ogni chunk contiene testo parziale fino a quando l'ultimo chunk non include l'utilizzo dei 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)

Lo streaming riduce la latenza percepita per le risposte lunghe. Consente anche di mostrare i progressi agli utenti in tempo reale. La finestra di contesto supporta 100,000 token per prompt e completamento insieme.

Limiti di frequenza e contesto

Hai un limite di 300 richieste al minuto per chiave. Solo 8 richieste possono essere eseguite simultaneamente. Il corpo della richiesta non deve superare gli 8 MB. Questi limiti garantiscono prestazioni stabili per tutti gli utenti.

Il modello supporta il function calling, la modalità JSON e i parametri standard come seed e presence_penalty. L'output massimo è di 16,000 token per richiesta. Se non imposti max_tokens, il valore predefinito è 2,048.

Errori e risoluzione dei problemi

Un errore 401 significa che la tua chiave API non è valida o è scaduta. Controlla la dashboard per la tua chiave attiva. Un errore 402 indica credito prepagato insufficiente. Aggiungi fondi tramite criptovalute per continuare. Un errore 429 significa che hai raggiunto il limite di velocità. Attendi qualche secondo e riprova.

Gli errori non consumano il tuo credito. Se avviene un doppio addebito, usa la pagina Supporto per risolverlo. Il credito non scade mai, quindi puoi ricaricare in un secondo momento.

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