Cursor IDE através do Model Gate

O Cursor usa o endpoint compatível com OpenAI:

https://api.model-gate.com/v1

1. Crie uma chave API

Abrir https://panel.model-gate.com/en/api-keys, crie uma chave e copie-a imediatamente.

2. Configurar Cursor

1. Abra Configurações do cursor. 2. Abra Modelos ou Chaves de API, dependendo da versão do Cursor instalada. 3. Insira a chave Model Gate no campo Chave da API OpenAI. 4. Ative a substituição do URL base do OpenAI. 5. Defina o URL base para:

https://api.model-gate.com/v1

6. Adicione um modelo personalizado usando um alias curto do Model Gate. O cursor pode rejeitar ou reescrever IDs de modelos canônicos completos, portanto, use um alias como ch-47 em vez de claude-opus-4.7. 7. Verifique a configuração e inicie um novo chat.

As chaves de API personalizadas no Cursor se aplicam aos recursos padrão do modelo de chat. Os recursos especializados hospedados no Cursor podem continuar a usar a infraestrutura do Cursor.

Aliases de modelo

No Cursor, especifique o alias do modelo, por exemplo ch-47, em vez do ID do modelo original, como claude-opus-4.7. O cursor pode rejeitar ou reescrever nomes completos de modelos devido às suas restrições internas de nomes de modelos. O Model Gate, portanto, oferece suporte a aliases gerenciados pelo administrador.

Os aliases atualmente habilitados estão listados abaixo:

Alias	Model
ch-46	claude-opus-4-6
ch-46s	claude-sonnet-4-6
ch-47	claude-opus-4-7
ch-48	claude-opus-4-8
ch-g54	gpt-5.4

Exemplo:

Cursor model: ch-47
Resolved model: claude-opus-4.7

Model Gate resolve o alias antes:

- verificações de disponibilidade de modelos; - preços oficiais e de usuário; - cálculo do custo de utilização; - enfileiramento assíncrono; - entrega a montante; - armazenamento de histórico de solicitações.

A resposta upstream pode conter o ID do modelo canônico.

Verifique fora do Cursor

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }'

Solução de problemas

Problema	Resolução
O cursor rejeita um ID de modelo longo	Use um alias curto habilitado mostrado por /v1/models.
A autenticação falha	Insira novamente a chave do Model Gate e verifique-a com curl.
As solicitações não chegam ao Model Gate	Confirme se o URL base inclui /v1.
O modelo não foi encontrado	O alias pode ser desabilitado ou mapeado para um modelo desabilitado.
Um recurso Cursor ignora a API personalizada	Teste um modelo de chat padrão; nem todos os recursos hospedados pelo Cursor oferecem suporte a chaves de API personalizadas.

Documentação atual da chave da API do Cursor: https://docs.cursor.com/settings/api-keys.