Guide de démarrage rapide API Gemma

Authentification et URL de base

Commencez par générer votre clé sur le tableau de bord. Utilisez l'URL de base fournie pour acheminer les requêtes vers notre modèle sans censure. L'authentification repose sur un en-tet standard.

URL de base: HTTPS://api.apigemma.com/v1

En-tête: Authorization: Bearer YOUR_API_KEY

Une seule clé active par compte. La remplacer révoque immédiatement l'ancienne. Aucun numéro de téléphone n'est requis pour l'inscription.

Point de terminaison des complétions de chat

Envoyez des prompts textuels à l'endpoint de complétion de chat. Le modèle retourne du texte sans refus de contenu pour un usage adulte licite.

Fenêtre de contexte : 100 000 jetons. Sortie max : 16 000 jetons. Les erreurs et les refus sont gratuits.

Prend en charge les appels de fonctions, le mode JSON et le streaming via SSE.

Réponses en streaming avec SSE

Activez le streaming en définissant le stream flag à true. Recevez des tokens en temps réel via des événements envoyés par le serveur (SSE).

L'utilisation de tokens est rapportée dans le dernier chunk. C'est idéal pour les interfaces de chat et les pipelines de synthèse vocale.

Les événements de flux sont fiables et suivent les formats standard OpenAI.

Mode JSON et appel de fonctions

Forcez une sortie structurée en définissant response_format à json_object. Cela garantit un analyse prévisible pour les applications en aval.

Utiliser tools pour l'appel de fonction. Le modèle gère l'exécution des outils sans problème.

Paramètres comme temperature et top_p contrôle la créativité et l'aléatoire.

Paramètres : température, top_p et seed

Maîtrisez la variation de sortie avec temperature (0-2), top_p (0-1), et seed pour la reproductibilité.

Utiliser stop séquences pour tronquer les réponses. presence_penalty et frequency_penalty Réduire la répétition.

Ces paramètres fonctionnent exactement comme le SDK OpenAI.

Limites, erreurs et fenêtre de contexte

Limite de taux : 300 requêtes/minute, 8 requêtes simultanées. Taille maximale du corps : 8 Mo.

401: Clé invalide. 402: Pas de crédit. 429: Limite de taux dépassée.

La fenêtre de contexte est de 100 000 jetons. La sortie maximale est de 16 000 jetons.

cURL

Copycurl https://api.apigemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the gemma model weights config file"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)