Inicio rápido de la API de Wu Shencha

Configuración básica

La API de Wu Shencha ofrece una interfaz compatible con OpenAI. Debes configurar la URL base y la clave de API en tu código. La URL base es fija: https://api.wushenchaapi.com/v1. El ID del modelo es uncensored, un modelo de pesos abiertos ajustado, diseñado para escenarios sin censura y que admite contenido adulto legal.

La clave se muestra en la página "Obtener clave de API" tras registrarte. Como es compatible con OpenAI, solo debes cambiar el parámetro base_url del SDK oficial. No necesitas rutas ni configuraciones complejas.

Endpoint de chat completions

Usa el endpoint POST /v1/chat/completions para enviar solicitudes de texto. Acepta formato de mensajes estándar y devuelve texto generado. Es la interacción básica para la mayoría de escenarios de generación de texto.

El cuerpo de la petición debe incluir model, messages y otros campos. Asegúrate de que el tamaño del cuerpo no supere los 8 MB. Si la clave de API no es válida o el saldo es insuficiente, la API devolverá los códigos de error correspondientes.

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

SDK Python

Usa el SDK oficial openai para Python. Apunta base_url al endpoint de Wu Shencha y pasa tu clave de API. Esto mantiene la compatibilidad con el código nativo de OpenAI para facilitar la migración.

Instala la versión más reciente del SDK. El código muestra cómo inicializar el cliente y enviar mensajes. Es un método conciso y eficiente para prototipado rápido.

复制from openai import OpenAI

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

SDK Node.js

Los desarrolladores de Node.js también pueden conectarse usando el paquete npm openai. La configuración es similar a la de Python: establece baseURL y apiKey. Esto garantiza la consistencia entre lenguajes y reduce el coste de aprendizaje.

Soporta peticiones asíncronas y manejo de errores. Integra fácilmente tu app Node.js. Maneja callbacks o Promises para evitar bloqueos.

复制import OpenAI from "openai";

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

Streaming

Admite streaming a través de Server-Sent Events (SSE). Configura el parámetro stream: true para que la API devuelva los datos de respuesta por bloques. Esto es muy útil para aplicaciones en tiempo real o para la generación de texto largo, ya que ofrece una experiencia de menor latencia.

El streaming no cambia el comportamiento del modelo, solo la transmisión de datos. Elige streaming o no streaming según necesites.

复制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 y cuotas

Máximo 300 peticiones por minuto. La ventana de contexto es de 100,000 tokens (incluyendo prompt y completion). Si superas el límite, la API devuelve un error 429. Devuelve 401 si la clave es inválida y 402 si el saldo es insuficiente.

El crédito prepago no caduca y no hay cuota mensual. El límite de cuerpo de cada petición es 8 MB. Estos límites garantizan estabilidad. Puedes generar nuevas claves para invalidar las antiguas.