Inicio Rápido con la API LLM de WaveSpeed: Endpoint, Clave API y Configuración Compatible con OpenAI
Las tres preguntas que todo nuevo usuario LLM de WaveSpeed se hace: ¿qué endpoint, qué clave API, qué protocolo? Esta guía responde las tres con código listo para copiar y pegar en Python, Node.js y curl.
Explora más de 290 LLMs en WaveSpeedAI — Claude, GPT, Gemini, Qwen, DeepSeek, Llama, Grok, Mistral y más, todos detrás de un único endpoint compatible con OpenAI. Catálogo de LLMs → · Playground →
Los Tres Campos que Necesitas Completar
Cuando conectas un nuevo proveedor de LLM a una aplicación de chat, un SDK o un IDE, casi siempre te piden las mismas tres cosas:
- Endpoint / URL base — dónde vive la API.
- Clave API — cómo el proveedor sabe que eres tú.
- Protocolo de chat — OpenAI Chat Completions, Anthropic Messages u otro.
Para WaveSpeed LLM, las respuestas son simples:
| Campo | Valor |
|---|---|
| URL base | https://llm.wavespeed.ai/v1 |
| Clave API | Tu clave API de WaveSpeed (desde el panel de control) |
| Protocolo | OpenAI Chat Completions (compatible directamente con los SDKs de OpenAI) |
Eso es todo. Si una herramienta admite “endpoint personalizado compatible con OpenAI”, WaveSpeed LLM funciona.
¿Qué es WaveSpeed LLM?
WaveSpeed LLM es una API unificada que te da acceso a más de 290 modelos de lenguaje de más de 30 proveedores a través de un único endpoint compatible con OpenAI — Claude Opus 4.6, GPT-5.2, Gemini 3, DeepSeek, Llama 4, Qwen 3, Grok 4, Mistral y más. Una clave API, una URL base, un formato de solicitud.
Sin arranques en frío. Pago por token. Sin suscripciones. Nivel gratuito para comenzar.
Paso 1: Obtén Tu Clave API
- Ve a wavespeed.ai e inicia sesión (Google/correo electrónico).
- Abre el panel de control y encuentra la sección API Keys.
- Crea una nueva clave — tiene el aspecto de una cadena aleatoria larga. Cópiala inmediatamente y guárdala como un secreto.
Trata esta clave como una contraseña. No la incluyas en git, no la pegues en capturas de pantalla.
Paso 2: Configura la URL Base
La API de LLM vive en:
https://llm.wavespeed.ai/v1
Por lo tanto, el endpoint de Chat Completions es:
https://llm.wavespeed.ai/v1/chat/completions
En cualquier lugar donde una herramienta solicite “URL base de OpenAI”, “Endpoint de API” o “URL de servidor personalizado”, pega https://llm.wavespeed.ai/v1.
Paso 3: Elige un Modelo
Los IDs de modelo usan el formato proveedor/modelo. Algunos de los más populares:
| ID del modelo | Notas |
|---|---|
anthropic/claude-opus-4.6 | Contexto de 1M, visión + uso de herramientas |
openai/gpt-5.2-pro | Contexto de 400K, razonamiento top de OpenAI |
google/gemini-3-flash-preview | Rápido, multimodal |
deepseek/deepseek-v4 | Pesos abiertos, excelente para programación |
meta-llama/llama-4-70b | Abierto, económico, estable |
Explora el catálogo completo en wavespeed.ai/llm.
Paso 4: Realiza Tu Primera Llamada
Python (SDK de OpenAI)
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://llm.wavespeed.ai/v1"
)
response = client.chat.completions.create(
model="anthropic/claude-opus-4.6",
messages=[
{"role": "user", "content": "Hello!"}
]
)
print(response.choices[0].message.content)
Node.js (SDK de OpenAI)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://llm.wavespeed.ai/v1'
});
const response = await client.chat.completions.create({
model: 'anthropic/claude-opus-4.6',
messages: [{ role: 'user', content: 'Hello!' }]
});
console.log(response.choices[0].message.content);
curl
curl https://llm.wavespeed.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "anthropic/claude-opus-4.6",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Nota que las únicas diferencias respecto a llamar directamente a OpenAI son: la base_url y la cadena del model. Tu código existente de OpenAI funciona sin cambios en todo lo demás.
Streaming, Herramientas y Visión
Todo lo que usas en el endpoint de Chat Completions de OpenAI funciona en WaveSpeed LLM:
stream: truepara streaming mediante eventos enviados por el servidor.toolsytool_choicepara llamadas a funciones (en los modelos que lo admiten).response_format: { type: "json_object" }para el modo JSON.- Entrada de imágenes mediante
content: [{ type: "image_url", image_url: { url: "..." } }]en modelos con capacidad de visión.
Como el protocolo es idéntico, cualquier biblioteca o framework construido sobre OpenAI — LangChain, LlamaIndex, Vercel AI SDK, Haystack — funciona simplemente cambiando la URL base.
Solución de Problemas
“Clave API inválida” / errores 401
Verifica que estás usando la clave API del panel de control de WaveSpeed, no la de OpenAI u otro proveedor. El encabezado debe ser Authorization: Bearer <clave>.
“Modelo no encontrado” / error 404 en el modelo
Los IDs de modelo distinguen entre mayúsculas y minúsculas y deben incluir el prefijo del proveedor. Usa anthropic/claude-opus-4.6, no claude-opus-4.6 ni Claude-Opus-4.6.
“Protocolo incorrecto” Si una herramienta te pide elegir entre “OpenAI”, “Anthropic”, “Gemini” o similar — elige siempre OpenAI. WaveSpeed LLM utiliza OpenAI Chat Completions para todos los modelos, incluidos Claude y Gemini. El prefijo del proveedor en el ID del modelo selecciona el modelo de origen; el formato de la solicitud sigue siendo compatible con OpenAI.
Problemas de red / conectividad
El endpoint es https://llm.wavespeed.ai/v1 — nota el subdominio llm. (no api.). Si tu firewall bloquea subdominios personalizados, añade llm.wavespeed.ai a la lista de permitidos.
Por Qué WaveSpeed LLM
- Una integración, más de 290 modelos. Cambia
anthropic/claude-opus-4.6poropenai/gpt-5.2-prosin modificar una sola línea de código. - Compatible con OpenAI. Funciona con todos los SDKs de OpenAI, LangChain, Vercel AI SDK y cualquier herramienta que acepte una URL base personalizada.
- Sin arranques en frío, sin suscripciones. Paga solo por lo que usas, con precios transparentes por token.
- Nivel gratuito. Empieza a crear sin necesidad de tarjeta de crédito.
Empieza a Crear Hoy
Tres campos — URL base, clave API, protocolo OpenAI — y ya estás dentro.
Obtén tu clave API en wavespeed.ai/llm y realiza tu primera llamada en menos de cinco minutos.




