Início Rápido com a API LLM do WaveSpeed: Endpoint, Chave de API e Configuração Compatível com OpenAI

Explore mais de 90 LLMs no WaveSpeedAI — Claude, GPT, Gemini, Qwen, DeepSeek, Llama, Grok, Mistral e muito mais por trás de um único endpoint compatível com OpenAI. Catálogo de LLMs → · Playground →

Os Três Campos que Você Precisa Preencher

Quando você conecta um novo provedor de LLM a um aplicativo de chat, um SDK ou uma IDE, quase sempre são solicitados os mesmos três elementos:

1. Endpoint / URL Base — onde a API está hospedada.
2. Chave de API — como o provedor sabe que é você.
3. Protocolo de chat — OpenAI Chat Completions, Anthropic Messages ou outro.

Para o WaveSpeed LLM, as respostas são simples:

Campo	Valor
URL Base	https://llm.wavespeed.ai/v1
Chave de API	Sua chave de API WaveSpeed (obtida no painel)
Protocolo	OpenAI Chat Completions (compatível como substituto direto dos SDKs OpenAI)

É só isso. Se uma ferramenta suporta “endpoint personalizado compatível com OpenAI”, o WaveSpeed LLM funciona.

O que é o WaveSpeed LLM?

O WaveSpeed LLM é uma API unificada que oferece acesso a mais de 90 modelos de linguagem de mais de 30 provedores por meio de um único endpoint compatível com OpenAI — Claude Opus 4.6, GPT-5.2, Gemini 3, DeepSeek, Llama 4, Qwen 3, Grok 4, Mistral e muito mais. Uma chave de API, uma URL base, um formato de requisição.

Sem cold starts. Pague por token. Sem assinaturas. Plano gratuito para começar.

Passo 1: Obtenha Sua Chave de API

1. Acesse wavespeed.ai e faça login (Google/e-mail).
2. Abra o painel e localize a seção API Keys.
3. Crie uma nova chave — ela parece uma string aleatória longa. Copie imediatamente e armazene como segredo.

Trate essa chave como uma senha. Não a envie ao git, não a cole em capturas de tela.

Passo 2: Configure a URL Base

A API de LLM está em:

https://llm.wavespeed.ai/v1

O endpoint de Chat Completions é, portanto:

https://llm.wavespeed.ai/v1/chat/completions

Em qualquer lugar que uma ferramenta solicite “OpenAI Base URL”, “API Endpoint” ou “Custom Server URL”, cole https://llm.wavespeed.ai/v1.

Passo 3: Escolha um Modelo

Os IDs de modelos usam o formato vendor/modelo. Alguns dos mais populares:

ID do Modelo	Observações
deepseek/deepseek-v4-flash	Pesos abertos, forte em programação

Explore o catálogo completo em wavespeed.ai/llm.

Passo 4: Faça Sua Primeira Chamada

Python (SDK OpenAI)

import os
from openai import OpenAI, OpenAIError

api_key = os.getenv("WAVESPEED_API_KEY")
if not api_key:
    raise RuntimeError("Set WAVESPEED_API_KEY before running this example")

client = OpenAI(
    base_url="https://llm.wavespeed.ai/v1",
    api_key=api_key,
    timeout=120.0,
    max_retries=2,
)

# The SDK sends this request to https://llm.wavespeed.ai/v1/chat/completions.
try:
    response = client.chat.completions.create(
        model="deepseek/deepseek-v4-flash",
        messages=[{"role": "user", "content": "Hello!"}],
    )
    print(response.choices[0].message.content or "")
except OpenAIError as exc:
    raise SystemExit(f"LLM request failed: {exc}") from exc

Node.js (SDK OpenAI)

import OpenAI from 'openai';

if (!process.env.WAVESPEED_API_KEY) throw new Error('Set WAVESPEED_API_KEY');

const client = new OpenAI({
  apiKey: process.env.WAVESPEED_API_KEY,
  baseURL: 'https://llm.wavespeed.ai/v1',
  timeout: 120_000,
  maxRetries: 2
});

try {
  const response = await client.chat.completions.create({
    model: 'deepseek/deepseek-v4-flash',
    messages: [{ role: 'user', content: 'Hello!' }]
  });
  console.log(response.choices[0]?.message?.content ?? '');
} catch (error) {
  console.error('LLM request failed:', error);
  process.exitCode = 1;
}

curl

curl --fail-with-body --connect-timeout 10 --max-time 120 --retry 2 --retry-all-errors \
  https://llm.wavespeed.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Observe que as únicas diferenças em relação a chamar a OpenAI diretamente são: a base_url e a string model. O restante do seu código OpenAI existente funciona sem alterações.

Streaming, Ferramentas e Visão

Tudo que você usa no endpoint de Chat Completions da OpenAI funciona no WaveSpeed LLM:

• stream: true para streaming de eventos enviados pelo servidor.
• tools e tool_choice para chamada de funções (em modelos que suportam).
• response_format: { type: "json_object" } para modo JSON.
• Entrada de imagem via content: [{ type: "image_url", image_url: { url: "..." } }] em modelos com capacidade de visão.

Como o protocolo é idêntico, qualquer biblioteca ou framework construído sobre a OpenAI — LangChain, LlamaIndex, Vercel AI SDK, Haystack — funciona apenas trocando a URL base.

Solução de Problemas

“Chave de API inválida” / erros 401 Verifique se está usando a chave de API do painel WaveSpeed, e não da OpenAI ou de outro provedor. O cabeçalho deve ser Authorization: Bearer <chave>.

“Modelo não encontrado” / 404 no modelo Os IDs de modelos diferenciam maiúsculas de minúsculas e devem incluir o prefixo do vendor. Use deepseek/deepseek-v4-flash, não claude-opus-4.6 nem Claude-Opus-4.6.

“Protocolo errado” Se uma ferramenta pedir para escolher entre “OpenAI”, “Anthropic”, “Gemini” ou similar — sempre escolha OpenAI. O WaveSpeed LLM utiliza o protocolo OpenAI Chat Completions para todos os modelos, incluindo Claude e Gemini. O prefixo do vendor no ID do modelo seleciona o modelo upstream; o formato da requisição permanece compatível com OpenAI.

Problemas de rede / conectividade O endpoint é https://llm.wavespeed.ai/v1 — observe o subdomínio llm. (não api.). Se seu firewall bloquear subdomínios personalizados, inclua llm.wavespeed.ai na lista de permissões.

Por que WaveSpeed LLM

• Compatível com OpenAI. Funciona com todos os SDKs OpenAI, LangChain, Vercel AI SDK e qualquer ferramenta que aceite uma URL base personalizada.
• Sem cold starts, sem assinaturas. Pague apenas pelo que usar, com preços transparentes por token.
• Plano gratuito. Comece a desenvolver sem cartão de crédito.

Comece a Desenvolver Hoje

Três campos — URL base, chave de API, protocolo OpenAI — e você está pronto.

Obtenha sua chave de API em wavespeed.ai/llm e faça sua primeira chamada em menos de cinco minutos.