documentación de la clave API de Gemma

Autenticación y URL base

Usa tu clave API única para autenticar cada solicitud. La URL base es HTTPS://api.gemmaapikey.com/v1 y envías la clave en el encabezado Authorization. Esto funciona con cualquier cliente compatible con OpenAI cambiando base_url y la clave API. Si la pierdes, genera una nueva desde el panel. La clave antigua deja de funcionar inmediatamente. Los errores y rechazos no consumen tu crédito prepagado.

Primera solicitud

Envía una solicitud POST a /v1/chat/completions con el id del modelo "uncensored". Incluye tu instrucción del sistema y el mensaje del usuario en el array messages. El modelo responde con texto generado sin rechazos de contenido para uso adulto lícito.

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)

Establece temperature y top_p para controlar la aleatoriedad. Usa secuencias de parada para detener la generación temprano. La respuesta incluye el uso de tokens en el último fragmento si el streaming está habilitado.

Integración del SDK Node

Instala el SDK oficial de OpenAI para Node.js. Configúralo con tu clave de API y la URL base de esta guía. Llama al método chat.completions.create con tu 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);

Este enfoque mantiene los costes predecibles porque pagas solo por los tokens utilizados. El crédito prepagado se cobra según el uso real. No hay cuotas mensuales. Puedes recargar con criptomonedas en cualquier momento.

Respuestas en streaming

Habilita la transmisión estableciendo stream en true en tu solicitud. La API devuelve fragmentos de Eventos Enviados por Servidor (SSE). Cada fragmento contiene texto parcial hasta que el último fragmento incluya el uso de tokens.

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)

El streaming reduce la latencia percibida para respuestas largas. También te permite mostrar el progreso a los usuarios en tiempo real. La ventana de contexto admite 100,000 tokens para prompt y finalización juntos.

Límites de velocidad y contexto

Estás limitado a 300 solicitudes por minuto por clave. Solo 8 solicitudes pueden ejecutarse simultáneamente. El cuerpo de la solicitud no debe exceder los 8 MB. Estos límites garantizan un rendimiento estable para todos los usuarios.

El modelo admite llamadas a funciones, modo JSON y parámetros estándar como seed y presence_penalty. La salida máxima es de 16.000 tokens por solicitud. Si no estableces max_tokens, el valor predeterminado es 2.048.

Errores y Solución de Problemas

Un error 401 significa que tu clave API es inválida o ha expirado. Consulta el panel para obtener tu clave activa. Un error 402 indica saldo prepagado insuficiente. Recarga mediante criptomonedas para continuar. Un error 429 significa que has alcanzado el límite de tasa. Espera unos segundos y reintenta.

Los errores no consumen tu crédito. Si se produce un cobro doble, usa la página de Soporte para solucionarlo. El crédito nunca expira, por lo que puedes recargar más tarde.

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