Inicio rápido para usuarios de Qwen

Autenticación y URL base

Nuestra API utiliza autenticación estándar con token Bearer. Recibes tu clave inmediatamente después de registrarte con Google o correo electrónico. Mantén esta clave segura; proporciona acceso a tu crédito prepago. La URL base para todas las peticiones es https://api.qwenapi.cc/v1. Actualiza la configuración de tu cliente para apuntar a este endpoint en lugar de la URL predeterminada de OpenAI.

La autenticación se maneja pasando el encabezado Authorization con cada petición. Sin una clave de API, el modelo no puede verificar el saldo de tu cuenta, lo que resulta en un error 401. No se requieren encabezados ocultos ni esquemas de autenticación personalizados.

Primera petición

Envía una petición estándar de completación de chat para probar la conectividad. Reemplaza YOUR_API_KEY con tu clave real. El endpoint acepta cargas útiles JSON estándar con los campos model, messages y content.

• Identificador del modelo: uncensored
• Endpoint: POST /v1/chat/completions
• Formato: JSON

Esta petición consumirá tokens de entrada de tu saldo. Asegúrate de que tu cliente maneje correctamente la respuesta JSON para verificar que la conexión está funcionando.

Integración con SDK de Python

Usa la biblioteca oficial de OpenAI para Python. Requiere configuración mínima para enrutar el tráfico a nuestro endpoint. Inicializa el cliente con tu clave y la URL base correcta. Este enfoque aprovecha las bases de código existentes sin reescribir la lógica de las peticiones.

Pasa el ID del modelo uncensored al crear la respuesta. La biblioteca maneja la serialización y deserialización automáticamente. Este método se recomienda para la mayoría de las integraciones de backend y flujos de trabajo basados en scripts.

Integración con SDK de Node.js

Para entornos de JavaScript o TypeScript, usa @anthropic-ai/sdk o el paquete estándar de OpenAI para Node. Configura la URL base para que apunte a nuestra API. Esto te permite integrar nuestro servicio en aplicaciones Node existentes sin una gran reestructuración.

Asegúrate de usar una versión reciente del SDK que admita URLs base personalizadas. Pasa el identificador del modelo uncensored para seleccionar nuestro modelo sin censura. Esta configuración funciona perfectamente con rutas de Express o funciones sin servidor.

Respuestas en streaming

Habilita el streaming estableciendo stream: true en tu petición. La API devuelve Server-Sent Events (SSE) a medida que el modelo genera texto. Esto proporciona menor latencia para los usuarios finales y permite la visualización en tiempo real de la salida.

Las estadísticas de uso de tokens se incluyen en el último fragmento del flujo. Procesa cada delta incrementalmente para construir la respuesta completa. Esta función es esencial para interfaces de chat y aplicaciones que requieren retroalimentación inmediata.

Límites, errores y contexto

Respeta los límites de peticiones para evitar interrupciones del servicio. La API permite 300 peticiones por minuto y 8 peticiones simultáneas por clave. El tamaño máximo del cuerpo de la petición es de 8 MB. Si excedes estos límites, recibirás un error 429.

Los errores de autenticación devuelven 401, lo que indica una clave inválida o faltante. Los errores de saldo devuelven 402, lo que significa que tu crédito prepago se ha agotado. La ventana de contexto admite 100.000 tokens en total, con un máximo de 32.000 tokens de salida por petición. Los errores y rechazos no consumen créditos.

cURL

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

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)