Guía de inicio rápido de la API de Gemma

Autenticación y URL base

Empieza por generar tu clave en el panel de control. Usa la URL base proporcionada para enrutar las solicitudes a nuestro modelo sin censura. La autenticación depende de un encabezado estándar.

URL Base: HTTPS://api.apigemma.com/v1

Encabezado: Authorization: Bearer YOUR_API_KEY

Solo una clave activa por cuenta. Reemplazarla revoca la antigua inmediatamente. No se requiere número de teléfono para registrarse.

Endpoint de completados de chat

Envía prompts de texto al punto de conexión de completados de chat. El modelo devuelve texto sin rechazos de contenido para uso adulto lícito.

Ventana de contexto: 100,000 tokens. Salida máxima: 16,000 tokens. Los errores y las denegaciones no cuestan nada.

Compatible con llamadas a funciones, modo JSON y streaming vía SSE.

Respuestas en streaming con SSE

Habilita el streaming estableciendo el stream flag a true. Reciba tokens en tiempo real mediante Eventos Enviados por el Servidor.

El uso de tokens se informa en el fragmento final. Esto es ideal para interfaces de chat y pipelines de síntesis de voz.

Los eventos de flujo son confiables y siguen los formatos estándar de OpenAI.

modo JSON y llamada de funciones

Fuerza una salida estructurada estableciendo response_format para json_object. Esto asegura un análisis consistente para aplicaciones posteriores.

Usar tools para llamadas de funciones. El modelo maneja la ejecución de herramientas sin problemas.

Parámetros como temperature y top_p controla la creatividad y la aleatoriedad.

Parámetros: temperatura, top_p y seed

Controla la variación de la salida con temperature (0-2), top_p (0-1), y seed para la reproducibilidad.

Usar stop secuencias para truncar las respuestas. presence_penalty y frequency_penalty reduce la repetición.

Estos parámetros funcionan exactamente igual que el SDK.

Límites, errores y ventana de contexto

Límite de velocidad: 300 solicitudes/minuto, 8 solicitudes concurrentes. Tamaño máximo del cuerpo: 8 MB.

401: Clave inválida. 402: Sin crédito. 429: Límite de tasa excedido.

La ventana de contexto es de 100.000 tokens. La salida máxima es de 16.000 tokens.

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);

Transmisión

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)