Documentación de la API de Ollama para Desarrolladores

Autenticación y URL base

Usar https://api.ollamaendpointurl.com/v1 como tu URL base e incluye tu clave API en la Authorization header.

• URL Base: https://api.ollamaendpointurl.com/v1
• Encabezado: Authorization: Bearer YOUR_API_KEY

Genera tu clave al instante mediante Google o correo electrónico en el panel de control. No se requiere número de teléfono. Esta URL funciona con cualquier SDK estándar de OpenAI anulando la URL base.

Primera solicitud

Envía una solicitud POST a /v1/chat/completions con el ID del modelo uncensored y tus mensajes.

Copycurl https://api.ollamaendpointurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the default port for Ollama?"}]
  }'

Esto devuelve una respuesta JSON que contiene el texto generado. Si recibes un error 401, tu clave API no es válida. Un error 402 indica que tienes crédito prepagado insuficiente.

Integración del SDK de Python

Inicializa el cliente con tu clave y la URL base personalizada para enviar solicitudes de forma programática.

Copyfrom openai import OpenAI

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

Establecer max_tokens para controlar la longitud de la salida. Sin él, el valor predeterminado es 2,048 tokens. El modelo acepta parámetros estándar como temperature y top_p para ajustar el comportamiento de generación.

Integración del SDK Node

Configura el cliente Node.js para apuntar a nuestro punto de conexión para una integración perfecta en tus scripts.

Copyimport OpenAI from "openai";

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

El SDK gestiona la serialización automáticamente. Asegúrate de estar utilizando una versión reciente del SDK de OpenAI que admita URLs base personalizadas. Los errores se lanzan como excepciones de API estándar.

Respuestas en streaming

Habilita la transmisión estableciendo stream: true para recibir tokens mediante Server-Sent Events (SSE).

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)

Los detalles de uso de tokens aparecen en el último fragmento del flujo. Esto reduce la latencia percibida para salidas largas. El endpoint admite formato SSE estándar compatible con la mayoría de las bibliotecas cliente.

Límites de velocidad y ventana de contexto

Cada clave de API está limitada a 300 solicitudes por minuto y 8 solicitudes concurrentes. La ventana de contexto es de 100,000 tokens en total. La salida máxima por solicitud es de 16,000 tokens. Las solicitudes con un cuerpo superior a 8 MB se rechazan. Un error 429 indica que has alcanzado el límite de velocidad. Espera brevemente antes de reintentar. Los errores y las denegaciones no consumen saldo. El saldo nunca expira. Usa criptomonedas para recargar. Comienza con un saldo de prueba de $0.50. Obtén tu clave ahora.