Guía de inicio rápido de Wu Xianzhi API

Endpoint base de API y autenticación

Wu Xianzhi API es totalmente compatible con la interfaz estándar de OpenAI. Todas las peticiones se envían a https://api.wuxianzhiapi.com/v1. Necesitas una clave de API para la autenticación, incluyéndola en el encabezado Authorization: Bearer YOUR_API_KEY. Tras registrarte, la clave se genera al instante y puedes regenerarla en cualquier momento para invalidar la anterior. Usamos un modelo de pago por uso con crédito prepago que no caduca y sin cuotas de suscripción.

Enviar la primera petición

Puedes verificar la conectividad de la API directamente con curl. Envía una petición POST a /v1/chat/completions, especificando el ID del modelo como uncensored. Este modelo de pesos abiertos independiente está optimizado para contenido adulto legal y temas controvertidos, sin rechazar la generación de contenido.

Asegúrate de que el cuerpo de la petición incluya la matriz messages. Si la autenticación falla, se devuelve 401; si el saldo es insuficiente, se devuelve 402.

复制curl https://api.wuxianzhiapi.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."}]
  }'

Ejemplo de uso del SDK Python

Para desarrolladores de Python, usa directamente la biblioteca oficial openai. Solo necesitas modificar base_url para apuntar a nuestro servidor e introducir la clave de API correcta. El ID del modelo es fijo: uncensored. Nota: solo soportamos generación de texto; no ofrecemos embeddings ni capacidades multimodales. Este método es ideal para la integración de servicios backend y el manejo sencillo de interacciones de datos estructurados.

复制from openai import OpenAI

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

Integración con SDK Node.js

Los desarrolladores de Node.js también pueden integrar el paquete npm openai. Tras configurar baseURL y apiKey, la lógica de llamada es idéntica a la de OpenAI. Esta API de LLM uncensored admite llamadas a funciones; puedes definir funciones mediante el parámetro tools y el modelo devolverá JSON estructurado para su ejecución. Es el backend ideal para aplicaciones de IA sin restricciones.

复制import OpenAI from "openai";

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

Respuesta en streaming (SSE)

Para reducir la latencia del primer token, te recomendamos configurar stream: true en la petición. La API devolverá respuestas en fragmentos mediante Server-Sent Events (SSE). Esto es crucial para diálogos en tiempo real o generación de texto largo. El cliente debe escuchar el evento data, analizar los fragmentos JSON y concatenar el contenido final. El streaming no altera la facturación; se cobra por el total de tokens de entrada y salida.

复制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)

Límites, manejo de errores y ventana de contexto

Cada clave de API tiene un límite de 300 peticiones por minuto y el cuerpo de la petición no debe superar 8 MB. La ventana de contexto es de 100.000 tokens (incluyendo prompt y respuesta). Los códigos de error son: 401 (clave inválida), 402 (saldo insuficiente) y 429 (límite de peticiones superado). El modelo bloquea estrictamente el contenido sexual con menores, pero permite todo el contenido adulto legal sin censura. Para obtener la lista de modelos, usa GET /v1/models.