Documentación de API para desarrolladores

URL Base y autenticación

La URL base es HTTPS://api.ollamaapiurl.com/v1. Te autenticas pasando tu clave API única en el encabezado Authorization. Esta clave actúa como tus credenciales para todas las solicitudes. Recómodala desde tu panel inmediatamente después del registro.

• Mantén tu clave segura. Otorga acceso completo a tu crédito prepagado.
• Genera una clave nueva en cualquier momento desde la página de configuración.

El sistema de nuestra clave de API es simple. Una clave activa por cuenta asegura un seguimiento claro. Si pierdes el acceso, regénerala al instante. Sin verificación de número de teléfono que bloquee tu entrada.

Primera solicitud

Envía tu primer prompt usando HTTP estándar. El endpoint acepta entrada de texto y devuelve salida de texto. Este método funciona con cualquier biblioteca de cliente HTTP que prefieras.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

La respuesta incluye el uso de tokens. Solo pagas por los tokens procesados. Los errores no consumen tu saldo prepagado. Esta transparencia te permite controlar tus gastos con precisión.

Integración del SDK de Python

Usa la biblioteca oficial de Python de OpenAI. Señálala a nuestra URL base. Establece el id del modelo a uncensored. Esto asegura que obtengas el comportamiento sin censura sin las molestias de la configuración local.

Copyfrom openai import OpenAI

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

La biblioteca maneja los reintentos y el formato. Obtienes JSON estructurado o texto sin formato. También se admite streaming. Este enfoque mantiene tu código limpio y mantenible.

Configuración del SDK Node

Instala el paquete openai. Configura la URL base para apuntar a nuestro servicio. Establece la clave de API desde tu entorno. Esta configuración refleja estrechamente la configuración de Python.

Copyimport OpenAI from "openai";

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

Los desarrolladores de Node obtienen un comportamiento consistente. El modelo responde a los prompts al instante. Puedes integrarlo en cualquier servidor web o trabajador en segundo plano. No se necesita lógica de enrutamiento compleja.

Respuestas de streaming

Activa la transmisión estableciendo stream en true. La API devuelve fragmentos a medida que se generan. Esto mejora la latencia percibida para los usuarios. Puedes mostrar los tokens a medida que aparecen.

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 último fragmento contiene el recuento total de tokens. Úsalo para verificación de facturación. El streaming funciona con todos los parámetros. También soporta llamadas a funciones. Tus usuarios ven el progreso en tiempo real.

Límites, errores y contexto

Tu ventana de contexto abarca 100.000 tokens en total. Esto incluye tanto prompt como completado. Puedes generar hasta 16.000 tokens por solicitud. El límite de tasa permite 300 solicitudes por minuto. Las solicitudes concurrentes se limitan a ocho por clave.

Los errores comunes incluyen 401 para claves inválidas. Un error 402 significa que tu crédito prepagado se ha agotado. Una respuesta 429 indica que alcanzaste el límite de velocidad. Verifica tu panel de control para recargar mediante criptomonedas. Los créditos nunca expiran. Errores como cargos dobles se solucionan a través de soporte.