Referencia de API de GitHub Uncensored AI

Autenticación & URL base

La API requiere un token bearer para cada solicitud. Generas esta clave al instante a través del panel de control usando credenciales de Google o correo electrónico. Una vez creada, la clave autentica tu cuenta prepagada contra el modelo alojado.

Configura tu URL base para apuntar directamente a nuestra puerta de enlace de API. Esto asegura que todas las solicitudes se enruten al servidor del modelo uncensored correcto.

Usa la cabecera Authorization estándar con el esquema Bearer. Reemplaza el marcador con tu cadena de clave única.

Configuración Base

• URL base: https://api.githubuncensoredai.com/v1
• Cabecera de autenticación: Authorization: Bearer YOUR_API_KEY
• ID del Modelo: uncensored

Copycurl https://api.githubuncensoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python loop"}]
  }'

Endpoint Chat Completions

Envía datos de texto al punto de conexión de completados de chat y recibe texto generado como respuesta. El sistema acepta una lista de mensajes con roles como user o assistant. Devuelve una finalización basada en el historial de prompts.

Este extremo maneja flujos de conversación estándar. Puedes enviar múltiples turnos, y el modelo mantiene el contexto hasta el límite. No admite entradas de imágenes, audio ni video. El formato de respuesta es JSON estándar.

Asegúrate de que tu carga útil incluya el identificador del modelo. El sistema ignora los campos desconocidos de manera elegante. Los errores devuelven códigos específicos si falla la autenticación o se agotan los créditos.

Copyfrom openai import OpenAI

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

Respuestas en streaming

Habilita el streaming estableciendo la bandera stream en true. La API devuelve una serie de Server-Sent Events en lugar de un único objeto JSON. Cada evento contiene un fragmento del texto generado.

Este enfoque reduce la latencia percibida para respuestas largas. Puedes empezar a mostrar texto a los usuarios a medida que se genera. El último fragmento incluye las estadísticas de uso de tokens para la facturación.

Maneja el flujo de manera eficiente en el código del cliente. Cierra la conexión cuando finalice el flujo o se produzca un error. Este método funciona bien para interfaces de chat en tiempo real.

Copyimport OpenAI from "openai";

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

Llamada de funciones y modo JSON

El modelo admite salida estructurada mediante llamadas a funciones. Define herramientas en tu solicitud con nombres, descripciones y esquemas de parámetros. El modelo selecciona la herramienta adecuada y genera los argumentos.

Usa el modo JSON para un cumplimiento estricto del esquema. Establece el formato de respuesta a json_object para forzar una salida JSON válida. Esto es útil para analizar datos o generar fragmentos de código.

Combina la llamada de funciones con streaming para experiencias interactivas. El modelo puede invocar múltiples herramientas en secuencia. Valida el esquema de salida antes de ejecutar funciones en la lógica de tu aplicació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)

Parámetros & Límites

Controla el comportamiento de generación con parámetros como temperature y top_p. Ajusta estos valores para equilibrar la creatividad y la determinismo. La configuración predeterminada funciona para la mayoría de los propósitos generales.

Respeta los límites de solicitud para evitar errores. Puedes enviar hasta 300 solicitudes por minuto por clave. Las solicitudes concurrentes están limitadas a ocho por clave. El tamaño máximo del cuerpo de la solicitud es de 8 MB.

La ventana de contexto abarca 100,000 tokens. Esto incluye tanto tokens de prompt como de completación. La salida está limitada a 16,000 tokens por solicitud. Exceder estos límites devuelve un código de error.

Uso de Token y Facturación

La facturación es prepagada y se basa en el uso real de tokens. Los tokens de entrada cuestan $0.15 por millón y los tokens de salida cuestan $0.50 por millón. Los errores y las denegaciones no consumen créditos.

El crédito nunca caduca. Las recargas se procesan únicamente con cripto. Recibes crédito adicional por depósitos más grandes. El sistema registra el uso con precisión para cada clave de API.

Monitorea tu saldo a través del panel de control. Si los créditos se agotan, tus solicitudes fallarán con un código de error específico. Añade fondos al instante para reanudar el servicio sin esperar aprobaciones.