Actualizado en agosto de 2026 · Guía de integración de la API

Guía de la API de Qwen: integración con Python & Node.js fuera de China

Qwen3.8 de Alibaba rivaliza con GPT-5.6 Sol en el Artificial Analysis Intelligence Index y admite un contexto de hasta 1 millón de tokens. Esta guía muestra cómo acceder a la API de Qwen globalmente mediante el endpoint compatible con OpenAI de ChinaModelAPI, con ejemplos prácticos de código en Python y Node.js.

from openai import OpenAI
client = OpenAI(api_key="YOUR_KEY", base_url="https://api.chinamodelapi.com/v1")
print(client.chat.completions.create(
    model="qwen-plus",
    messages=[{"role":"user","content":"ping"}],
).choices[0].message.content)

¿Qué es la API de Qwen?

La API de Qwen es la interfaz para desarrolladores de Alibaba Cloud para su serie de modelos de lenguaje grande Qwen (通义千问). La API sigue el formato de chat completions de OpenAI, lo que la convierte en una alternativa directa para los desarrolladores que ya utilizan modelos GPT.

Datos clave de la API de Qwen:

  • Compatible con OpenAI — mismo formato de solicitud/respuesta que GPT
  • Ventana de contexto de Qwen-Max — hasta 1,000,000 de tokens
  • Idiomas — multilingüe (100+), destaca en chino-inglés
  • AA Intelligence Index — nivel superior de pesos abiertos, competitivo con GPT-5.6 Sol
  • Soporta — chat, function calling, streaming, visión (Qwen-VL)

Modelos Qwen: ¿cuál usar?

ID del modelo Ideal para Contexto Velocidad Coste
qwen-3 Tareas generales, rendimiento más reciente 128K Rápido $$
qwen-max Documentos extensos, razonamiento complejo 1M Moderada $$$
qwen-plus Equilibrado: velocidad + calidad 128K Rápido $$
qwen-2.5 Cargas de trabajo estables en producción 128K Rápido $
qwen-2.5-coder Generación & completado de código 128K Rápido $

Cómo acceder a la API de Qwen fuera de China: 4 pasos

  1. 1
    Create a ChinaModelAPI account

    Regístrate en chinamodelapi.com: no se requiere tarjeta de crédito.

  2. 2
    Purchase tokens with USDT

    El plan Starter ($9.9) es suficiente para realizar pruebas. Los tokens nunca caducan.

  3. 3
    Copy your API key

    Tu clave del panel de control funciona con todos los modelos Qwen.

  4. 4
    Change base_url in your SDK

    Una línea de código: consulta los ejemplos a continuación.

Integración en Python: API de Qwen

Instala el SDK de OpenAI para Python: pip install openai

qwen_basic.py
from openai import OpenAI

client = OpenAI(
    base_url="https://api.chinamodelapi.com/v1",
    api_key="your-chinamodelapi-key"
)

response = client.chat.completions.create(
    model="qwen-3",  # or qwen-max, qwen-plus, qwen-2.5
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain transformer architecture in 3 sentences."}
    ],
    max_tokens=1024
)

print(response.choices[0].message.content)

Para respuestas en streaming:

qwen_streaming.py
stream = client.chat.completions.create(
    model="qwen-max",
    messages=[{"role": "user", "content": "Write a Python function for binary search."}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Integración en Node.js: API de Qwen

Instalación: npm install openai

qwen.js
import OpenAI from "openai";

const client = new OpenAI({
    baseURL: "https://api.chinamodelapi.com/v1",
    apiKey: "your-chinamodelapi-key"
});

const response = await client.chat.completions.create({
    model: "qwen-3",  // or "qwen-max", "qwen-plus"
    messages: [
        { role: "user", content: "Translate this to Chinese: Hello, world!" }
    ]
});

console.log(response.choices[0].message.content);

Preguntas frecuentes

¿Puedo usar la API de Qwen de forma gratuita?

ChinaModelAPI no ofrece un plan gratuito, pero el plan Starter de $9.9 proporciona una cantidad importante de tokens para pruebas y proyectos pequeños. Los tokens nunca caducan, por lo que no hay prisa por consumirlos.

¿La API de Qwen admite function calling?

Sí. Qwen3.8 y Qwen-Max admiten function calling (uso de herramientas) compatible con OpenAI. El formato de la solicitud es idéntico al de OpenAI: define tus herramientas en el parámetro tools y el modelo devolverá llamadas a funciones estructuradas.

¿Cuál es la ventana de contexto de Qwen-Max?

Qwen-Max admite hasta 1,000,000 tokens de contexto, lo que equivale aproximadamente a 750,000 palabras o a un libro completo. Esta es una de las mayores ventanas de contexto disponibles, lo que la hace ideal para analizar documentos extensos, bases de código o artículos de investigación.

¿Existe un límite de peticiones en la API de Qwen?

Los límites de peticiones dependen del nivel de tu plan. Starter cuenta con límites básicos adecuados para el desarrollo. Pro y superiores ofrecen un mayor rendimiento. Los planes Enterprise incluyen límites de peticiones personalizados y garantías de SLA. Contáctanos para conocer cifras específicas.

Guías relacionadas

¿Listo para usar la API de Qwen? Obtén acceso en menos de 5 minutos.

Obtener Acceso Anticipado