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

Explore mais de 290 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:

Endpoint / URL Base — onde a API está hospedada.
Chave de API — como o provedor sabe que é você.
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 290 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

Acesse wavespeed.ai e faça login (Google/e-mail).
Abra o painel e localize a seção API Keys.
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
`anthropic/claude-opus-4.6`	Contexto de 1M, visão + uso de ferramentas
`openai/gpt-5.2-pro`	Contexto de 400K, raciocínio OpenAI de ponta
`google/gemini-3-flash-preview`	Rápido, multimodal
`deepseek/deepseek-v4`	Pesos abertos, forte em programação
`meta-llama/llama-4-70b`	Aberto, econômico, estável

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

Passo 4: Faça Sua Primeira Chamada

Python (SDK 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 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!"}]
  }'

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 anthropic/claude-opus-4.6, 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

Uma integração, mais de 290 modelos. Substitua anthropic/claude-opus-4.6 por openai/gpt-5.2-pro sem alterar uma linha de código.
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.