WaveSpeedAI
← Blog

Use Cursor com WaveSpeed LLM: Guia de Endpoint de API Personalizado

Configure o Cursor para usar o WaveSpeed LLM com Claude Opus 4.6, GPT-5.2, Gemini 3 e mais de 290 outros modelos. Tutorial completo de configuração — endpoint, chave de API, ID do modelo.

By WaveSpeedAI 4 min read
Use Cursor com WaveSpeed LLM: Guia de Endpoint de API Personalizado

O Seu Cursor, Os Seus Modelos

O Cursor vem com seus próprios modelos hospedados por padrão, mas todo usuário sério do Cursor eventualmente quer trazer suas próprias chaves — para economizar dinheiro, desbloquear um modelo específico ou rotear requisições por um gateway interno. O WaveSpeed LLM resolve os três ao mesmo tempo: um endpoint compatível com OpenAI, mais de 290 modelos, cobrança por token, sem fidelização a assinatura.

Este guia percorre as configurações exatas do Cursor que você precisa.

O Que Você Vai Configurar

CampoValor
Tipo de provedorOpenAI (compatível com OpenAI)
URL base / Overridehttps://llm.wavespeed.ai/v1
Chave de APISua chave de API do WaveSpeed
ID do modelovendor/model — ex: anthropic/claude-opus-4.6

Passo 1: Obtenha Sua Chave de API do WaveSpeed

  1. Faça login em wavespeed.ai.
  2. Abra Dashboard → API Keys.
  3. Crie e copie uma nova chave.

Passo 2: Abra as Configurações de Modelos do Cursor

  1. Inicie o Cursor.
  2. Abra Settings (Cmd/Ctrl + Shift + J).
  3. Vá para Models.

Você verá uma lista de modelos hospedados pelo Cursor por padrão e uma seção para provedores personalizados.

Passo 3: Adicione o WaveSpeed como Endpoint OpenAI Personalizado

  1. Role até OpenAI API Key (ou seção equivalente de provedor personalizado).

  2. Cole sua chave de API do WaveSpeed no campo OpenAI API Key.

  3. Clique em Override OpenAI Base URL (ou alternância similar).

  4. Cole a URL base:

    https://llm.wavespeed.ai/v1

  5. Clique em Verify / Save. O Cursor enviará uma requisição de teste.

Se a verificação for bem-sucedida, sua chave e URL base estão configuradas corretamente.

Passo 4: Adicione os IDs de Modelo do WaveSpeed

O Cursor permite adicionar nomes de modelos personalizados ao provedor OpenAI. Adicione os IDs de modelo do WaveSpeed que deseja usar:

  • anthropic/claude-opus-4.6
  • anthropic/claude-sonnet-4.6
  • openai/gpt-5.2-pro
  • openai/gpt-5.2-chat
  • google/gemini-3-flash-preview
  • deepseek/deepseek-v4

Salve. Esses modelos aparecerão agora no seletor de modelos do Cursor na barra lateral de chat e na interface de edição inline.

Passo 5: Use

Abra qualquer projeto no Cursor, pressione Cmd/Ctrl + L para abrir o chat e escolha um modelo WaveSpeed no menu suspenso. Faça uma pergunta sobre sua base de código. Você deverá ver uma resposta em streaming normal — o Cursor agora está roteando pelo WaveSpeed.

Edições inline (Cmd/Ctrl + K) e completação por tab também usarão o modelo selecionado onde for suportado.

Modelos Recomendados para o Cursor

ID do ModeloPonto Forte
anthropic/claude-opus-4.6Melhor raciocínio de longo contexto e refatoração
anthropic/claude-sonnet-4.6Claude rápido para edições do dia a dia
openai/gpt-5.2-proAlternativa sólida de raciocínio
openai/gpt-5.2-chatEquilíbrio entre velocidade e qualidade
deepseek/deepseek-v4Codificador forte mais barato

Experimente alguns na mesma tarefa e escolha o seu favorito.

Solução de Problemas

“Invalid OpenAI API Key” A chave de API do WaveSpeed vai no campo OpenAI API Key do Cursor. O override da URL base diz ao Cursor para onde enviá-la.

“Model not found” O Cursor envia diretamente ao endpoint qualquer string de modelo que você selecionou. É necessário incluir o prefixo do vendor — anthropic/claude-opus-4.6, não claude-opus-4.6.

A verificação falha com erro de rede Verifique se a URL base é exatamente https://llm.wavespeed.ai/v1 — barras no final, ausência de v1 ou uso de api.wavespeed.ai causarão falha.

Alguns recursos do Cursor não funcionam com um endpoint personalizado Alguns recursos avançados do Cursor (como os recursos baseados em indexação do próprio Cursor) dependem de modelos hospedados pelo Cursor e não usarão seu provedor personalizado. Chat, edições inline e completações funcionam normalmente.

Por Que Esta Configuração Vale a Pena

  • Economize dinheiro em dias intensos. Execute grandes refatorações com openai/gpt-5.2-pro pelo preço por token do WaveSpeed em vez de esgotar uma cota fixa de assinatura do Cursor.
  • Acesse modelos que o Cursor não hospeda. Qwen 3, DeepSeek V4, Llama 4, Grok 4 — qualquer coisa no catálogo do WaveSpeed.
  • Uma única fatura. Consolide seu uso do Cursor, seus scripts de API e seus apps de chat em uma única conta WaveSpeed.

Comece a Programar Hoje

Dois campos — URL base e chave de API — e você está executando o Cursor com mais de 290 modelos.

Obtenha sua chave de API do WaveSpeed e aponte o Cursor para https://llm.wavespeed.ai/v1 em minutos.

Compartilhar