Documentation clé API Gemma

Authentification et URL de base

Utilisez votre clé API unique pour authentifier chaque requête. L'URL de base est HTTPS://api.gemmaapikey.com/v1 et vous envoyez la clé dans l'en-tête Authorization. Cela fonctionne avec n'importe quel client compatible OpenAI en modifiant base_url et la clé API. Si vous la perdez, générez-en une nouvelle depuis le tableau de bord. L'ancienne clé cesse immédiatement de fonctionner. Les erreurs et les refus ne consomment pas votre crédit prépayé.

Première demande

Envoyez une requête POST à /v1/chat/completions avec l'ID de modèle "uncensored". Incluez votre invite système et le message utilisateur dans le tableau messages. Le modèle répond avec du texte généré sans refus de contenu pour une utilisation adulte légale.

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)

Définissez temperature et top_p pour contrôler l'aléatoire. Utilisez des séquences stop pour arrêter la génération prématurément. La réponse inclut l'utilisation des jetons dans le dernier chunk si le streaming est activé.

Intégration du SDK Node

Installez le SDK officiel OpenAI pour Node.js. Configurez-le avec votre clé API et l'URL de base de ce guide. Appelez la méthode chat.completions.create avec votre 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);

Cette approche rend les coûts prévisibles car vous ne payez que pour les tokens utilisés. Le crédit prépayé est facturé en fonction de l'utilisation réelle. Aucun frais mensuel ne s'applique. Vous pouvez créditer votre compte avec de la crypto à tout moment.

Réponses en streaming

Activez le streaming en définissant stream sur true dans votre requête. L'API renvoie des chunks Server-Sent Events (SSE). Chaque chunk contient du texte partiel jusqu'à ce que le dernier chunk inclue l'utilisation des jetons.

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)

Le streaming réduit la latence perçue pour les réponses longues. Il vous permet également d'afficher les progrès aux utilisateurs en temps réel. La fenêtre de contexte prend en charge 100,000 tokens pour l'invite et la complétion combinées.

Limites de débit et contexte

Vous êtes limité à 300 requêtes par minute par clé. Seules 8 requêtes peuvent s'exécuter simultanément. Le corps de la requête ne doit pas dépasser 8 Mo. Ces limites garantissent des performances stables pour tous les utilisateurs.

Le modèle prend en charge l'appel de fonctions, le mode JSON et les paramètres standard tels que seed et presence_penalty. Le nombre maximal de jetons de sortie est de 16 000 par demande. Si vous ne définissez pas max_tokens, la valeur par défaut est de 2 048.

Erreurs et dépannage

Une erreur 401 signifie que votre clé API est invalide ou expirée. Consultez le tableau de bord pour votre clé active. Une erreur 402 indique un solde prépayé insuffisant. Rechargez via crypto pour continuer. Une erreur 429 signifie que vous avez atteint la limite de taux. Attendez quelques secondes et réessayez.

Les erreurs ne consomment pas votre crédit. En cas de double facturation, utilisez la page Support pour la corriger. Le crédit n'expire jamais, vous pouvez donc recharger plus tard.

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