Inicio rápido para usuarios de Ollama

Requisitos previos

Para usar esta API, necesitas una cuenta activa con una clave de API válida. Regístrate en la página Obtener clave de API con Google o con correo electrónico y contraseña. No se requiere número de teléfono. También necesitas un SDK de un lenguaje compatible instalado en tu máquina. Esta guía cubre Python y Node.js, los clientes más comunes para endpoints compatibles con OpenAI. La API sirve un único modelo sin censura identificado por uncensored. Acepta texto y devuelve texto. No hay funciones de incrustaciones, imágenes ni audio. Todas las peticiones van a https://api.ollamaapi.cc/v1.

Instalar SDK

Instala el SDK oficial para tu lenguaje preferido. Para Python, usa pip. Para Node.js, usa npm. Estas bibliotecas manejan automáticamente el protocolo HTTP, la serialización JSON y el streaming. No necesitas escribir peticiones HTTP en bruto a menos que prefieras ese nivel de control. Los SDKs están bien documentados y se usan ampliamente en entornos de producción. Asegúrate de que tu entorno cumpla con los requisitos del SDK. Se recomiendan Python 3.8+ y Node.js 18+. Mantén tus dependencias actualizadas para evitar problemas de compatibilidad con parámetros de modelo más nuevos.

Configurar cliente

Establece la URL base en nuestro endpoint. Este es el único cambio de configuración necesario para pasar de OpenAI a nuestro servicio sin censura. Pasa tu clave de API como cabecera de autorización. El SDK se encargará del resto. No cambies el nombre del modelo a gpt-4 ni similar; usa uncensored. La API sigue estrictamente el protocolo de chat-completions de OpenAI. Cualquier cliente que funcione con OpenAI funcionará aquí con estos dos cambios. Esto hace que la migración o las pruebas A/B sean sencillas. Puedes ejecutar ambas APIs lado a lado para comparar salidas.

Enviar primera petición

Realiza una petición POST a /v1/chat/completions. Incluye el ID del modelo, el prompt del sistema y el mensaje del usuario. La API devuelve una respuesta de texto. Si tienes crédito, la petición se realiza con éxito. Si no tienes crédito, obtendrás un error 402. Si tu clave no es válida, obtendrás un 401. Estos errores son estándar y fáciles de manejar en el código. El modelo no rechaza contenido adulto lícito, lo que lo hace útil para escritura creativa, investigación de seguridad o chat sin censura. Consulta tu saldo en el panel si no estás seguro de los créditos restantes.

Respuestas en streaming

Activa el streaming estableciendo stream: true. La API devuelve tokens a medida que se generan. Esto reduce la latencia percibida para los usuarios. El fragmento final contiene el uso total de tokens para la facturación. El streaming es compatible con todos los SDK oficiales. Es esencial para interfaces de chat donde deseas mostrar el texto a medida que se escribe. El servidor envía Server-Sent Events (SSE). Tu biblioteca cliente se encarga del análisis. No necesitas gestionar el flujo de eventos manualmente a menos que estés construyendo un cliente personalizado.

Límites, errores y contexto

La ventana de contexto es de 100.000 tokens en total, con un máximo de salida de 32.000 tokens. Las peticiones están limitadas a 300 por minuto y 8 peticiones simultáneas por clave. El cuerpo de la petición debe ser inferior a 8 MB. Los errores incluyen 401 para claves no válidas, 402 por crédito insuficiente y 429 por límites de peticiones. Estos son códigos HTTP estándar. Manejalos de forma elegante en tu aplicación. El modelo bloquea contenido sexual que involucre a menores. Se permite todo lo demás. El crédito no caduca, así que puedes pausar el uso sin perder fondos. Usa la página de soporte para problemas de reembolso.

cURL

Copycurl https://api.ollamaapi.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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