URL Base y Autenticación
Usa la URL base proporcionada y una clave de API válida para conectar tu cliente. El punto de conexión es https://api.qwencodeapikey.com/v1.Debes incluir tu clave en el Authorization header de cada solicitud. Esto asegura que el servicio identifique correctamente tu cuenta de crédito prepagado.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Puedes generar una clave a través de Google o correo electrónico en la página de registro. La clave aparece inmediatamente. Guárdala de forma segura, ya que controla tus gastos.
Endpoint Chat Completions
Envía mensajes a la /v1/chat/completions endpoint para obtener respuestas de texto. Esta es la interfaz estándar para la mayoría de los SDK de OpenAI. Defines el model como uncensored y proporciona una lista de mensajes en el messages array. La API procesa tu entrada y devuelve una finalización generada.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Asegúrate de que la biblioteca cliente apunte a la URL base correcta. El ID del modelo uncensored activa el modelo de peso abierto ajustado para fewer refusals. Maneja turnos de conversación igual que cualquier otra API de chat.
Endpoint de Models
Consulta GET /v1/models verificar los modelos disponibles y sus detalles. Este punto final devuelve una lista de modelos accesibles para tu clave. Te ayuda a confirmar el uncensored modelo está activo y listo para solicitudes. Usa esto para depurar configuraciones de cliente antes de enviar cargas completas.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Comprueba la estructura de la respuesta para asegurarte de que tu SDK analiza correctamente la lista de modelos. Este endpoint no consume crédito, lo que lo hace seguro para comprobaciones de inicialización.
Parámetros de solicitud y transmisión
Soporta parámetros estándar como temperature, top_p, stop, y seed. Habilita el streaming estableciendo stream: true. La API envía tokens mediante Server-Sent Events (SSE). Las estadísticas de uso de tokens aparecen en el último fragmento del flujo. Esto permite la visualización en tiempo real del texto generado.
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)
Establecer max_tokens para controlar la longitud de la salida. El valor predeterminado es 2,048 tokens. Puedes aumentar esto hasta 16,000 tokens por solicitud. Ajusta los parámetros para equilibrar la creatividad y la precisión en tus respuestas.
Límites de velocidad y restricciones
Cada clave permite 300 solicitudes por minuto y 8 solicitudes concurrentes. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Estos límites previenen el abuso y garantizan un rendimiento estable. Si excedes la tasa, recibirás un error 429. Ajusta la lógica de tu cliente para manejar reintentos con retroceso exponencial.
La ventana de contexto admite 100.000 tokens en total. Esto incluye tanto prompt como completion. Los contextos grandes requieren una gestión cuidadosa de tokens para permanecer dentro de los límites.
Modo JSON y llamada de funciones
Usar response_format: {"type": "json_object"} para una salida estructurada. Esto asegura que el modelo devuelva JSON válido, útil para la integración programática. La llamada de funciones funciona a través de tools parámetro. Define las herramientas en el formato estándar de OpenAI. El modelo llamará a las funciones según sea necesario.
Los errores y rechazos no consumen crédito. Esto aplica incluso si el modelo rechaza una solicitud debido al límite estricto de contenido. Solo pagas por el uso real de tokens. El crédito nunca vence, por lo que puedes recargar cuando te sea conveniente.
Gestión de errores y uso
Gestiona los errores HTTP de forma elegante. Un error 401 indica una clave API inválida o expirada. Un error 402 significa que se ha agotado tu crédito prepagado. Un error 429 señala que se ha excedido el límite de tasa. Comprueba el cuerpo de la respuesta para obtener mensajes de error detallados.
El uso se rastrea por clave. Una clave activa por cuenta simplifica la facturación. Si cometes un error, como un cargo doble, usa la página de Soporte. El crédito no se reembolsa pero sigue siendo válido. Los errores son gratuitos, por lo que las solicitudes fallidas no agotan tu saldo.
Resumen y mejores prácticas
Comienza con la URL base y una clave válida. Usa el uncensored ID del modelo para menos rechazos. Transmite respuestas para una mejor experiencia de usuario. Monitorea los límites de velocidad para evitar interrupciones. Usa el modo JSON para datos estructurados. Maneja errores para mantener la fiabilidad. El crédito es prepagado y nunca expira. Recarga con cripto cuando sea necesario. Esta API se integra perfectamente en codebases existentes de OpenAI. No se requieren nuevos SDKs. Solo cambia la URL base y la clave.
