Inicio rápido API Mukenetsu AI

Configuración básica y URL base

Mukenetsu AI es una API REST compatible con OpenAI. Puedes usar tus clientes y SDKs existentes con mínimos cambios. Usa la siguiente URL base para comunicarte con la API.

https://api.mukenetsuapi.com/v1

A diferencia de otros servicios LLM, no necesitas elegir endpoints complejos ni configurar extras. Solo ofrecemos un endpoint de chat completion y uno para listar modelos. Esta simplicidad acelera tu desarrollo.

La clave de API se obtiene al instante al registrarte con tu correo electrónico y contraseña en la página Obtener clave de API. No necesitas operar el panel de control. Además, priorizamos la privacidad: los datos del prompt no se usan para entrenar el modelo.

Autenticación y clave de API

El acceso a la API requiere autenticación mediante el encabezado Authorization: Bearer <API_KEY>. Utiliza la clave de API de Mukenetsu AI generada al crear la cuenta. Aunque se asigna una clave por cuenta, puedes regenerarla en cualquier momento si lo necesitas. Ten en cuenta que al regenerar la clave, la anterior quedará invalidada.

Si ocurre un error de autenticación, normalmente se devuelve una respuesta 401 (Unauthorized) o 402 (Payment Required). El 401 indica que la clave es incorrecta o está deshabilitada; el 402 significa que el saldo de crédito de tu cuenta es insuficiente. El crédito es prepago y puedes recargarlo desde $10 o más con criptomonedas (USDT, USDC).

Endpoint de chat completion

El endpoint principal para la generación de texto es POST /v1/chat/completions. Al enviar una petición a este endpoint, puedes generar texto incluyendo el historial de conversaciones y el prompt del sistema. Especifica el ID del modelo como uncensored. Se trata de un modelo de pesos abiertos único, diferente a los modelos GPT de OpenAI o de otros proveedores.

El siguiente ejemplo muestra cómo generar texto básico con curl. Los parámetros necesarios son el ID del modelo, los mensajes y, opcionalmente, activar el streaming.

コピーcurl https://api.mukenetsuapi.com/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."}]
  }'

Este endpoint no ofrece embeddings, generación de imágenes ni conversión de voz. Está especializado exclusivamente en la finalización y generación de texto.

Streaming (SSE)

Si deseas obtener el texto generado en tiempo real, puedes utilizar el modo streaming. Al incluir "stream": true en la petición, el servidor devuelve los datos de forma secuencial en formato de eventos enviados por el servidor (SSE). Esto permite al usuario mostrar parte del texto antes de que finalice la generación.

Si utilizas el SDK de OpenAI en Python o la biblioteca cliente de Node.js, el procesamiento de streaming se realiza automáticamente solo indicando la opción stream=True. El manejador de eventos recibe fragmentos por token.

コピーfrom openai import OpenAI

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

El streaming mejora la experiencia en respuestas largas o aplicaciones interactivas. Sin embargo, si se corta la conexión durante el streaming, no recibirás más eventos.

Llamadas a funciones

La API de Mukenetsu AI admite llamadas a funciones (tool calling). Esto facilita la integración con APIs externas o bases de datos. Al incluir el campo tools y el parámetro tool_choice en el cuerpo de la petición, puedes hacer que el modelo ejecute una función específica.

El modelo decide si llamar a una función o devolver texto normal según sea necesario. Una vez completada la llamada, puedes obtener una respuesta más detallada añadiendo el resultado de la función a messages y pasándoselo al modelo.

コピーimport OpenAI from "openai";

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

Esta función es ideal para aplicaciones tipo agente o automatización de tareas complejas. Al ser compatible con OpenAI, puedes reutilizar tu lógica existente de llamadas a funciones.

Límites de peticiones y restricciones

El uso de la API tiene las siguientes limitaciones: máximo 300 peticiones por minuto y un tamaño máximo del cuerpo de la petición de 8 MB. Si superas estos límites, se devuelve un error 429 (Too Many Requests). La ventana de contexto es de 100,000 tokens (suma del prompt y el texto generado). Para conversaciones o documentos largos, debes dividirlos apropiadamente antes de enviarlos.

Al recibir respuestas en streaming, sigue este flujo de eventos.

コピーstream = 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)

Además, el contenido sexual con menores está estrictamente limitado por razones legales. Otros contenidos adultos legales, ficción, investigación de seguridad y temas controvertidos se generan sin censura.