API de Gemma: primera petición en cinco minutos

URL base y autenticación

Empieza creando una cuenta en la página Obtener clave de API. Solo necesitas un correo electrónico y una contraseña; no se requiere número de teléfono ni tarjeta de crédito para activar el crédito de prueba. Una vez registrado, tu clave de API se muestra inmediatamente. Copia esta clave y guárdala de forma segura. Úsala en el encabezado Authorization como un token Bearer para todas las peticiones. La URL base para todos los endpoints es https://api.gemma4api.com/v1. Esta URL funciona con cualquier cliente compatible con OpenAI, permitiéndote cambiar de proveedor simplemente cambiando la URL base y la clave de API en tu configuración.

Primera petición

Envía tu primer prompt usando curl para verificar la conectividad. Reemplaza YOUR_API_KEY con tu clave real. El identificador del modelo es uncensored. Esta sencilla petición de texto a texto confirma que tu autenticación es correcta y que el modelo responde. Si recibes una respuesta JSON con una matriz choices, tu configuración está completa. Ahora puedes proceder a integrar el SDK para flujos de trabajo más complejos.

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

Integración con SDK de Python

Instala el paquete oficial de Python de OpenAI. Establece las variables de entorno de la URL base y la clave de API o pásalas directamente al constructor del cliente. Usa el ID del modelo uncensored para asegurarte de que estás llamando a nuestra instancia específica. Este enfoque asegura que tu código siga siendo compatible con los patrones estándar de OpenAI mientras aprovecha nuestro modelo sin censura para la generación de contenido. El SDK maneja los reintentos y el parsing JSON automáticamente.

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)

Integración con SDK de Node.js

Para entornos JavaScript, instala el paquete de Node.js de OpenAI. Configura el cliente con la URL base https://api.gemma4api.com/v1 y tu clave de API. Usa el ID del modelo uncensored en tus solicitudes de finalización. Esta configuración te permite mantener estructuras de código compatibles con OpenAI mientras te beneficias del comportamiento específico del modelo alojado en nuestros servidores. Asegúrate de manejar correctamente las respuestas asíncronas dentro del bucle de eventos de 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);

Respuestas en streaming

Habilita el streaming estableciendo el parámetro stream en true en tu petición de API. Esto devuelve un flujo de Server-Sent Events (SSE), permitiéndote mostrar tokens a medida que se generan. Esto es ideal para interfaces de chat donde importa la latencia. Cada fragmento contiene un delta parcial de la respuesta. Maneja el evento de fin de flujo para saber cuándo se completa la generación. Este método reduce significativamente la latencia percibida en comparación con esperar la respuesta 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)

Límites, errores y ventana de contexto

Tus peticiones admiten una ventana de contexto de 100.000 tokens para prompt y finalización combinados. El límite de peticiones es de 300 peticiones por minuto por clave, con un tamaño máximo de cuerpo de petición de 8 MB. Los errores comunes incluyen 401 para claves inválidas, 402 si tu crédito prepago se agota y 429 si superas el límite por minuto. Regenerar tu clave de API revoca la antigua pero no restablece el contador de límite. Asegúrate de que tu cliente maneje estos códigos de estado HTTP apropiadamente para mantener un funcionamiento fluido.