API Gemma: prima richiesta in cinque minuti

URL di base e Autenticazione

Inizia creando un account nella pagina Ottieni chiave API. Ti servono solo email e password; non è richiesto un numero di telefono o una carta di credito per attivare il credito di prova. Una volta registrato, la tua chiave API viene visualizzata immediatamente. Copia questa chiave e memorizzala in modo sicuro. Usala nell'intestazione Authorization come token Bearer per tutte le richieste. L'URL di base per tutti gli endpoint è https://api.gemma4api.com/v1. Questo URL funziona con qualsiasi client compatibile con OpenAI, permettendoti di cambiare provider semplicemente modificando l'URL di base e la chiave API nella tua configurazione.

Prima Richiesta

Invia il tuo primo prompt usando curl per verificare la connettività. Sostituisci YOUR_API_KEY con la tua chiave effettiva. L'identificatore del modello è uncensored. Questa semplice richiesta testo-in, testo-out conferma che l'autenticazione è corretta e che il modello risponde. Se ricevi una risposta JSON con un array choices, la configurazione è completa. Ora puoi procedere a integrare l'SDK per flussi di lavoro più complessi.

Copycurl https://api.gemma4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integrazione SDK Python

Installa il pacchetto Python ufficiale di OpenAI. Imposta le variabili di ambiente per l'URL di base e la chiave API o passale direttamente al costruttore del client. Usa l'ID del modello uncensored per assicurarti di chiamare la nostra istanza specifica. Questo approccio garantisce che il tuo codice rimanga compatibile con gli standard OpenAI sfruttando al contempo il nostro modello senza censura per la generazione di contenuti. L'SDK gestisce automaticamente i tentativi e l'analisi JSON.

Copyfrom openai import OpenAI

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

Integrazione SDK Node.js

Per gli ambienti JavaScript, installa il pacchetto OpenAI Node.js. Configura il client con l'URL di base https://api.gemma4api.com/v1 e la tua chiave API. Usa l'ID del modello uncensored nelle tue chiamate di completamento. Questa configurazione ti permette di mantenere strutture di codice compatibili con OpenAI beneficiando del comportamento specifico del modello ospitato sui nostri server. Assicurati di gestire correttamente le risposte asincrone all'interno del ciclo degli eventi Node.js.

Copyimport OpenAI from "openai";

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

Risposte in Streaming

Abilita lo streaming impostando il parametro stream su true nella tua richiesta API. Questo restituisce uno stream di Server-Sent Events (SSE), permettendoti di visualizzare i token man mano che vengono generati. È ideale per le interfacce chat dove la latenza è importante. Ogni chunk contiene un delta parziale della risposta. Gestisci l'evento di fine stream per sapere quando la generazione è completa. Questo metodo riduce significativamente la latenza percepita rispetto all'attesa della risposta completa.

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)

Limiti, Errori e Finestra di Contesto

Le tue richieste supportano una finestra di contesto di 100.000 token per prompt e completamento combinati. Il limite di richieste è di 300 richieste al minuto per chiave, con una dimensione massima del corpo della richiesta di 8 MB. Gli errori comuni includono 401 per chiavi non valide, 402 se il tuo credito prepagato è esaurito e 429 se superi il limite per minuto. Rigenerare la chiave API revoca quella vecchia ma non resetta il contatore del limite. Assicurati che il tuo client gestisca appropriatamente questi codici di stato HTTP per mantenere un funzionamento fluido.