API Qwen: primera petición en cinco minutos

URL base y autenticación

Nuestra API sigue el formato estándar de OpenAI, lo que facilita cambiar la configuración de tu cliente existente. La URL base para todas las peticiones es https://api.qwenapis.com/v1. Necesitarás una clave de API para autenticar tus peticiones. Si aún no has creado una, visita la página Obtener clave de API para generar una usando solo tu correo electrónico y contraseña. No se requiere tarjeta de crédito para comenzar con el crédito de prueba.

Cada cuenta tiene un límite de una clave activa a la vez. Puedes regenerar tu clave en cualquier momento, lo que revoca inmediatamente la anterior. Esto asegura que si tu clave se expone, puedas asegurar tu cuenta al instante sin esperar al ciclo mensual. Mantén tu clave segura en tus variables de entorno o gestor de secretos.

Realiza tu primera petición

Verifica tu configuración enviando una petición simple de finalización de texto. El siguiente ejemplo usa curl para enviar un prompt al modelo sin censura. Reemplaza YOUR_API_KEY con la clave generada en el paso anterior. El ID del modelo está configurado como uncensored, que está ajustado para responder sin rechazos de contenido para uso adulto lícito.

Copycurl https://api.qwenapis.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."}]
  }'

Si tienes éxito, recibirás una respuesta JSON que contiene el texto generado. Si recibes un error 401, verifica que tu clave sea correcta. Un error 402 indica que tu crédito prepago se ha agotado.

Integración con SDK de Python

Para desarrolladores de Python, el SDK oficial de OpenAI funciona directamente con nuestro endpoint. Instala la biblioteca usando pip, luego configura el cliente para apuntar a nuestra URL base. Esto te permite usar métodos familiares como chat.completions.create() sin cambiar significativamente la lógica de tu aplicación. El SDK maneja la serialización JSON y la lógica de reintento por ti.

Copyfrom openai import OpenAI

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

Recuerda configurar correctamente el api_key y el base_url. El nombre del modelo sigue siendo uncensored. Este enfoque asegura la compatibilidad con el código escrito para otros proveedores, facilitando cambiar o probar diferentes endpoints.

Uso del SDK de Node.js

Los desarrolladores de Node.js pueden usar el paquete npm @anthropic-ai/sdk o el oficial openai. Configura el cliente con nuestra URL base y tu clave de API. La estructura de la petición es idéntica a la de otros servicios compatibles con OpenAI. Esto te permite integrar Qwen sin censura en tus aplicaciones Node.js existentes con cambios mínimos de código.

Copyimport OpenAI from "openai";

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

Asegúrate de manejar la respuesta asíncrona apropiadamente. El SDK devolverá el objeto de finalización completo, incluidas las estadísticas de uso de tokens. Esto te ayuda a monitorear el consumo de tu crédito prepago en tiempo real.

Habilitar streaming

Para una menor latencia y una mejor experiencia de usuario, habilita el streaming en tus peticiones. El streaming envía la respuesta token por token a medida que se genera, permitiendo que tu aplicación muestre el progreso de la salida. Establece el parámetro stream en true en tu petición. El SDK proporcionará un flujo iterable de fragmentos.

Copystream = 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)

Esto es particularmente útil para la generación de contenido extenso o aplicaciones interactivas. Cada fragmento contiene texto parcial, que puedes agregar a tu búfer de visualización. El flujo termina cuando el modelo completa la respuesta o alcanza el límite de contexto.

Límites, errores y contexto

Nuestra API tiene límites específicos para garantizar un uso justo. Se te permiten 300 peticiones por minuto por clave. El tamaño máximo del cuerpo de la petición es 8 MB. La ventana de contexto es de 100.000 tokens, cubriendo tanto el prompt como la finalización. Si excedes el límite de peticiones, recibirás un error 429. Si tu crédito es insuficiente, recibirás un error 402. Para claves inválidas, recibirás un error 401. Estos errores te ayudan a gestionar el flujo de tu aplicación y el uso de crédito de manera efectiva.