Saltar para o conteúdo principal
Usando a API Gateway? Isso permite que você use os modelos do Alter em outros aplicativos como SillyTavern, NovelCrafter ou seu próprio código.

​
O que se passa?

Você está tentando conectar outro aplicativo à API do Alter, mas:
  • O aplicativo se conecta mas não mostra modelos disponíveis
  • Tem de escrever manualmente os nomes dos modelos
  • As solicitações do modelo falham a menos que você especifique o nome exato

​
Por que isso acontece

Muitos aplicativos de IA esperam o formato de modelo simples do OpenAI (como o gpt-5), mas o Alter suporta vários provedores. Então usamos um formato especial para identificar de qual provedor cada modelo vem.

​
A solução

Formato do modelo: Fornecedor#Model-name

Em vez de apenas gpt-5, use: OpenAI#gpt-5O formato é sempre: Nome do fornecedor + # + Nome do modelo

​
Passos de configuração

1

Obtenha suas credenciais de API

  1. Abrir Alter → Configurações (Cmd + ,)
  2. Ir para a página Router
  3. Clique em Adicionar nova chave para gerar uma chave API
  4. Copiar a chave (começa com sk-...)
  5. Observe o ponto final: https://alterhq.com/api
2

Configurar o seu aplicativo externo

No aplicativo que você está conectando:
  • ** URL da base:** https://alterhq.com/api (ou tente https://alterhq.com/api/v1)
  • ** Chave API:** Sua chave gerada a partir do passo 1
3

Defina o modelo manualmente

Como a listagem automática pode não funcionar, insira um modelo manualmente:
ProviderNome do modeloID completo
OpenAIGPT-5OpenAI#gpt-5
OpenAIGPT-5 NanoOpenAI#gpt-5-nano
ClaudeSonnet 4Claude#claude-sonnet-4-6
Gemini2.5 ProGemini#gemini-2.5-pro
MistralLargeMistral#mistral-large-latest
AlterBest RouterAlter#best

​
Testar a ligação

Tente este teste simples:
  1. Enviar um pedido de conclusão de chat com o modelo OpenAI#gpt-5-nano
  2. ** Sucesso: ** Deve obter uma resposta através do Alter
Se funcionar com um modelo, funcionará com todos eles – basta alterar o ID do modelo!
** Dica profissional:** A API Alter funciona exatamente como a API OpenAI. Se o seu aplicativo suporta os terminais “OpenAI-compatíveis”, ele funcionará com o Alter.

​
Ainda tens problemas?

  • Certifique-se de estar usando uma chave válida da API Alter (não a chave do provedor)
  • Tente ambos os objetivos: /api e /api/v1
  • Alguns aplicativos armazenam a lista de modelos – tente reiniciar o aplicativo após a configuração

​
Ajuda relacionada