Guía de inicio rápido del endpoint compatible con OpenAI

Prerrequisitos: Python o Node.js

Instala el openai paquete para tu entorno de ejecución antes de continuar.

Los usuarios de Python necesitan la versión 1.0.0 o posterior. Los desarrolladores de Node requieren la versión 4.0.0 o superior. Ambas versiones admiten la estructura estándar de chat-completions.

No se requieren dependencias adicionales. El SDK maneja automáticamente la serialización JSON y el transporte HTTP.

Configura base_url y la clave API

Apunta tu cliente del SDK a nuestra URL base y proporciona tu clave generada.

Usar https://api.openaicompatibleendpoint.com/v1 como la URL base. Establece la clave API en el valor que se muestra en tu panel.

• Python: base_url="https://api.openaicompatibleendpoint.com/v1"
• Node: baseURL: "https://api.openaicompatibleendpoint.com/v1"

Esta configuración funciona con cualquier cliente compatible con el SDK de OpenAI. No se necesitan cambios de código para el resto de tu lógica.

Envía tu primera finalización de chat

Hacer una solicitud POST a /v1/chat/completions con tus mensajes del sistema y del usuario.

El ID del modelo es uncensored. Este modelo responde sin rechazar temas adultos lícitos o controvertidos.

• Ventana de contexto: 100,000 tokens en total.
• Salida máxima: 16.000 tokens.

Envía tu prompt y recibe salida de texto inmediatamente. Los errores y las negaciones son gratuitos. Solo el uso real de tokens se descuenta de tu crédito prepagado.

Habilita la transmisión y la llamada de funciones

Habilita la transmisión estableciendo stream: true en tus parámetros de solicitud.

El uso de tokens se incluye en el último fragmento del stream. Esto te permite rastrear los costos en tiempo real.

La llamada a funciones es totalmente compatible. Utiliza el tools parámetro para definir tu esquema. El modelo devuelve llamadas de herramientas estructuradas que puedes ejecutar en la lógica de tu aplicación. El modo JSON también está disponible mediante response_format.

Gestiona errores y límites de tokens

La API devuelve códigos de estado HTTP estándar para problemas comunes.

• 401: Clave API inválida. Revisa tu panel de control.
• 402: Crédito insuficiente. Recarga con USDT o USDC.
• 429: Límite de velocidad excedido. Se te permiten 300 solicitudes por minuto.

Si superas el límite de salida de 16,000 tokens, la respuesta se truncará. La ventana de contexto incluye tanto tokens de prompt como de completación.

Precios y límites

Paga solo por lo que usas. Los tokens de entrada cuestan $0.15 por 1M. Los tokens de salida cuestan $0.50 por 1M.

El crédito prepagado nunca caduca. No se emiten reembolsos, pero los cargos duplicados se corrigen a través de Soporte.

Recarga solo con criptomonedas. Las monedas aceptables son USDT (TRC20) y USDC (Base). La recarga mínima es de $20. El crédito bonificado varía entre +5% y +15% según la cantidad.

cURL

Copycurl https://api.openaicompatibleendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return list of supported file formats"}]
  }'

Python

Copyfrom openai import OpenAI

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