Inicio rápido con 4-4 AI: conéctate a una API de IA unificada en 5 minutos
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
- Visita www.4-4.vip, crea una cuenta e inicia sesión en la consola;
- Recarga saldo en la consola o canjea un código de tarjeta;
- 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.
Concepto clave: Base URL y clave
4-4 AI ofrece un protocolo de interfaz totalmente compatible con OpenAI. Solo tienes que recordar dos configuraciones:
| Elemento | Valor |
|---|---|
| Base URL | https://www.4-4.vip/v1 |
| API Key | La clave sk-... creada en la página de tokens de la consola |
| Parámetro model | Indica 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
- LangChain / LlamaIndex: usa sus componentes compatibles con OpenAI y apunta
base_url/openai_api_basea la dirección de arriba; - Cursor / Claude Code / Cherry Studio y otras herramientas de IA: introduce la Base URL y la clave en los ajustes de «API personalizada / compatible con OpenAI»;
- Desarrollo propio: cualquier cliente HTTP conforme al protocolo OpenAI puede llamar directamente, sin SDK adicional.
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
Una clave para GLM, DeepSeek, Qwen y más modelos destacados: facturación unificada y uso visualizado.
Ver modelos y precios Probar gratis