← Blog

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.

5 min read
Inicio Rápido con la API LLM de WaveSpeed: Endpoint, Clave API y Configuración Compatible con OpenAI

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:

  1. Endpoint / URL base — dónde vive la API.
  2. Clave API — cómo el proveedor sabe que eres tú.
  3. Protocolo de chat — OpenAI Chat Completions, Anthropic Messages u otro.

Para WaveSpeed LLM, las respuestas son simples:

CampoValor
URL basehttps://llm.wavespeed.ai/v1
Clave APITu clave API de WaveSpeed (desde el panel de control)
ProtocoloOpenAI 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

  1. Ve a wavespeed.ai e inicia sesión (Google/correo electrónico).
  2. Abre el panel de control y encuentra la sección API Keys.
  3. 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 modeloNotas
anthropic/claude-opus-4.6Contexto de 1M, visión + uso de herramientas
openai/gpt-5.2-proContexto de 400K, razonamiento top de OpenAI
google/gemini-3-flash-previewRápido, multimodal
deepseek/deepseek-v4Pesos abiertos, excelente para programación
meta-llama/llama-4-70bAbierto, 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: true para streaming mediante eventos enviados por el servidor.
  • tools y tool_choice para 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.6 por openai/gpt-5.2-pro sin 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.