FAQ de la API sin censura: registro, facturación, endpoints, códigos de error y límites de contenido

Registro y prueba gratis

¿Cómo me registro? ¿Necesito vincular una tarjeta?

Regístrate en /get-api-key/ con correo y contraseña. No hace falta vincular tarjeta. La clave de API se muestra al instante tras el registro, sin espera de aprobación.

¿Cuánto crédito de prueba tiene una cuenta nueva y por cuánto tiempo?

Las cuentas nuevas tienen $0.50 de crédito de prueba, válido durante 7 días. A $1.00 por millón de tokens generados, esto alcanza para generar aproximadamente 500.000 tokens de respuesta, suficiente para pruebas de integración y validaciones a pequeña escala.

¿Cuántas claves puede tener una cuenta y qué hago si se pierden?

Cada cuenta tiene una sola clave. Si se pierde o se expone, puedes regenerarla en la cuenta; la clave anterior se invalida inmediatamente. Todos los servicios que aún usen la clave anterior recibirán un 401, así que debes actualizar las variables de entorno después del cambio.

¿Qué pasa cuando caduca la prueba?

Al expirar el crédito de prueba, las peticiones devuelven 402 con el error no_credit. Para continuar, recarga el saldo prepago en tu cuenta; el código no necesita cambios.

Facturación y saldo

¿Cuál es el precio y cómo se factura?

Facturación por token: entrada $0,25 / millón de tokens, salida $1,00 / millón de tokens. Sin suscripción ni cuota mensual, pagas solo por lo que usas. Ver página de precios para detalles.

¿Caduca el saldo?

No. El saldo prepago recargado no tiene fecha de caducidad. Solo el crédito de prueba de $0,50 de la cuenta nueva tiene un límite de 7 días.

¿Cómo sé cuánto cuesta una petición?

El campo usage de la respuesta indica los tokens de entrada y salida; multiplica por el precio unitario para obtener el coste. En streaming, el último bloque también contiene usage; ten en cuenta que su choices es un array vacío.

¿Cómo evito cargos inesperados altos?

Usa max_tokens para limitar la salida (por defecto 2048) y recorta el historial en conversaciones multironda para que la entrada no crezca. Al ser prepago, las peticiones se detienen al agotarse el saldo, sin cargos extra.

¿Cuánto cuesta una petición normal de ejemplo?

Ejemplo: 2.000 tokens de entrada y 500 de salida. Entrada aprox. $0,0005, salida aprox. $0,0005, total aprox. $0,001. Mil peticiones así cuestan aprox. $1. Los valores exactos dependen del usage en la respuesta.

¿Qué pasa cuando se agota el saldo?

La API devuelve 402 con el error no_credit. Tras recargar, puedes continuar sin regenerar la clave.

Endpoints y parámetros

¿Cuál es la dirección del endpoint y el nombre del modelo?

Base URL: https://api.wuxianzhiapi.com/v1. El modelo es siempre uncensored. Endpoints disponibles: POST /v1/chat/completions y GET /v1/models.

¿Es compatible con los SDK de OpenAI?

Sí. Compatible con el SDK oficial de Python openai v1+ y npm openai v4+. Solo cambia base_url y la clave. Ver Ejemplos de código para implementación. Para migrar desde otros endpoints, consulta la guía de migración.

¿Cuál es la longitud del contexto? ¿Qué tan grande puede ser max_tokens?

La ventana de contexto es de 100.000 tokens, y la suma de prompt y salida no puede exceder este número. max_tokens tiene un valor predeterminado de 2048, con un máximo por solicitud de 32.000. El cuerpo de la petición no puede superar 8 MB.

¿Soporta streaming y llamadas a funciones?

Sí. Para streaming usa stream: true; el servidor añade un bloque final con usage. Para llamadas a funciones, usa los campos tools y tool_choice en formato OpenAI. Los resultados de las herramientas se devuelven como mensajes con role: "tool".

¿Por qué no hay texto en el último bloque de la respuesta en streaming?

Es un bloque de estadísticas de uso añadido automáticamente; choices es un array vacío y usage contiene el número de tokens de esta petición. Al analizar, comprueba primero si choices está vacío antes de extraer el contenido para evitar un error de índice fuera de límites.

¿Hay un límite de peticiones?

Cada clave permite 300 peticiones por minuto. Si se supera, se devuelve un 429; espera y reintenta. Se recomienda usar retroceso exponencial.

¿Soporta vectores, imágenes, audio o fine-tuning?

No se admiten. Aquí solo proporcionamos conversación de texto. Solo hay un modelo uncensored, sin embeddings, ni generación de imágenes, audio, video ni ajuste fino.

Códigos de error

Todas las respuestas de error son JSON con el formato {"error":{"code":...,"message":...}}. A continuación se explica cómo gestionar cada código de estado.

¿Qué significa un error 400?

El problema está en la petición. Lo más común es que la suma del prompt y max_tokens supere los 100,000 tokens, o que el formato JSON sea incorrecto o haya errores en los tipos de campo. Debes corregir la petición; reintentar no servirá de nada.

¿Cómo depurar un 401?

La clave no es válida o falta. Verifica si el encabezado de la petición es Authorization: Bearer <clave>, si las variables de entorno están activas, si se ha regenerado la clave y si la clave antigua caducó inmediatamente después de la regeneración.

¿Qué significa 402 no_credit?

El saldo se ha agotado o el crédito de prueba ha caducado. Recarga tu cuenta para restaurar el acceso; no necesitas cambiar la clave.

¿Qué significa 403 content_blocked?

La petición activó el bloqueo de contenido. El contenido sexual que involucra a menores siempre se bloquea, tanto en ficción como en roleplay, y no se puede ajustar. Modifica el contenido de la petición y vuelve a intentarlo; si envías la misma petición, el resultado será el mismo.

¿Qué ocurre con un 404?

Has accedido a un endpoint que no existe. Lo más habitual es que falte /v1 en la URL o que hayas llamado a un endpoint no soportado, como embeddings o generación de imágenes.

¿Cómo gestionar 429 y 503?

429 indica que has superado el límite de 300 peticiones por minuto; 503 devuelve el código upstream_busy, indicando que el modelo está ocupado temporalmente. Prueba de nuevo en unos segundos. Para ambos casos es adecuado usar retroceso exponencial; consulta la página de ejemplos de código.

Límites de contenido

¿El modelo "sin censura" puede generar cualquier cosa?

No. El contenido adulto legal, la creación ficticia y los temas controvertidos no se rechazan, pero el contenido sexual que implica a menores se bloquea siempre, devolviendo 403, sea ficticio o de rol. El uso debe ser legal.

¿A qué usuarios va dirigido?

Solo para usuarios adultos mayores de 18 años. Si lo usas para un producto dirigido a usuarios finales, debes implementar la confirmación de mayoría de edad en tu aplicación y conservar mecanismos de reporte y gestión de cuentas.

¿Se puede usar para roleplay, novelas o videojuegos?

Sí, es el uso más típico. Consulta la página Aplicaciones para ejemplos de prompts y estimaciones de coste por escenario.

¿En qué casos del roleplay se devuelve un 403?

Solo cuando se activa el bloqueo de contenido, típicamente por contenido sexual con menores, incluso en ficción. El contenido legal entre adultos no se rechaza por ser roleplay. Si recibes un 403, ajusta la personalidad o la trama y vuelve a pedirlo.

¿Son fiables los hechos en la salida del modelo?

No necesariamente. Que no rechace contenido no significa que sea preciso. Para conclusiones sobre hechos, datos, leyes o medicina, debes verificarlos tú mismo antes de usarlos.

Privacidad

¿Se usarán mis prompts para entrenar el modelo?

No. Los prompts que envías no se utilizan para el entrenamiento.

¿Cómo debo guardar mi clave?

Coloca la clave en las variables de entorno del servidor; no la escribas en páginas front-end, paquetes de aplicaciones móviles ni repositorios de código públicos. Si sospechas que se ha expuesto, regénerala inmediatamente en la cuenta; la clave anterior se invalidará al instante.

¿Cómo debo gestionar los datos de los usuarios en mi aplicación?

Depende de tu producto. Se recomienda enviar solo lo estrictamente necesario para la tarea. No incluyas información sensible como nombres reales, números de identificación o datos de contacto en los prompts. Asegúrate de especificar claramente el flujo de datos en tu política de privacidad.