Inicio rápido con 4-4 AI: conéctate a una API de IA unificada en 5 minutos

Tutorial · 2026-11-20 · 8 min de lectura

Este tutorial te guía de cero a la conexión completa con 4-4 AI: obtener la clave → configurar la Base URL → ejecutar la primera salida en streaming. Todo se hace con la interfaz compatible con OpenAI — cualquier código, framework o herramienta existente que admita una Base URL personalizada (SDK de openai, LangChain, Cursor, etc.) no necesita cambios en la lógica del código, solo en la configuración.

Preparación previa

  1. Visita www.4-4.vip, crea una cuenta e inicia sesión en la consola;
  2. Recarga saldo en la consola o canjea un código de tarjeta;
  3. En la página «Tokens», crea una nueva clave API (formato sk-...) y guárdala con cuidado — solo se muestra completa una vez, al crearla.
Aviso de seguridad: una clave API equivale al crédito de la cuenta. No la subas a repositorios Git ni a código front-end. Mejor gestiona con variables de entorno.

Concepto clave: Base URL y clave

4-4 AI ofrece un protocolo de interfaz totalmente compatible con OpenAI. Solo tienes que recordar dos configuraciones:

ElementoValor
Base URLhttps://www.4-4.vip/v1
API KeyLa clave sk-... creada en la página de tokens de la consola
Parámetro modelIndica el nombre del modelo según necesidad, p. ej. deepseek-chat, glm-4, etc. (la lista de modelos de la consola es la referencia)

Cambiar de modelo = cambiar solo el parámetro model; cambiar de proveedor = cambiar solo la Base URL. Ese es el valor central de una pasarela unificada: desacoplar el código de negocio del proveedor de modelos.

Método 1: cURL (la forma más rápida de verificar la conectividad)

curl https://www.4-4.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $44AI_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence"}
    ]
  }'

Si el JSON devuelto contiene choices[0].message.content, toda la cadena funciona.

Método 2: Python (SDK oficial de openai)

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["44AI_API_KEY"],          # your 4-4 AI key
    base_url="https://www.4-4.vip/v1"            # key: point to the 4-4 AI gateway
)

# regular call
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)

# streaming output
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if delta and delta.content:
        print(delta.content, end="", flush=True)

Método 3: Node.js

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.N44_API_KEY,
  baseURL: "https://www.4-4.vip/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);

Conexión de frameworks y herramientas habituales

Preguntas frecuentes (FAQ)

¿Error 401 Invalid API Key?

Revisa en orden: ① si al copiar la clave se incluyeron espacios o saltos de línea; ② si la clave está desactivada/eliminada en la lista de tokens de la consola; ③ si el crédito de la cuenta se agotó; ④ si la cabecera Authorization tiene el formato Bearer sk-... (ojo al espacio después de Bearer).

¿Error 429, demasiadas peticiones?

La pasarela aplica un límite de ritmo por token. Reduce la concurrencia, alarga los back-offs de reintento (back-off exponencial + jitter recomendado) o sube el límite del token en la consola.

¿La salida en streaming se corta a mitad?

Para respuestas largas conviene activar el reintento por timeout del SDK; si pasas por un proxy corporativo, comprueba que no almacene en búfer el flujo SSE (text/event-stream).

¿Qué modelos admite?

La referencia es la lista en tiempo real de la página «Modelos» de la consola. 4-4 AI agrega GLM, DeepSeek, Qwen y más modelos destacados: una misma clave, una misma interfaz, y cambias de modelo.

Artículos relacionados

one-api / new-api autoalojado vs pasarela de IA gestionada: coste, operación y seguridad Un marco de decisión honesto para equipos que dudan entre «construir o comprar»: costes ocultos de operación, Conecta Cursor / Claude Code / Cherry Studio a una pasarela de IA personalizada Configuración de Base URL personalizada para las principales herramientas de código y chat de IA, con guía ráp
¿Listo para conectarte?

Una clave para GLM, DeepSeek, Qwen y más modelos destacados: facturación unificada y uso visualizado.

Ver modelos y precios Probar gratis