ai2saveai2save

Erros Comuns e Verificação de Conexão

401 / invalid_api_key

Confirme se a solicitação foi enviada para Base URL e se a Authorization usa Bearer sk-.... Verifique se a Key está completa, se não foi revogada e se o grupo ao qual pertence está correto.

404 / model not found

Verifique, em ordem, o ID do modelo, o endereço do protocolo e o grupo da Key. OpenAI Compatible geralmente usa o endereço com /v1; Claude Code geralmente usa o endereço raiz sem /v1.

403 ou bloqueio por controle de risco

Defina um User-Agent claro no script para reduzir a probabilidade de o User-Agent vazio ser bloqueado pelo gateway. Não tente contornar a restrição repetindo tentativas continuamente.

Solicitação muito lenta

Comece testando com perguntas curtas. Se perguntas curtas forem rápidas, mas tarefas complexas forem lentas, geralmente é devido ao contexto ou à inferência do modelo; se perguntas curtas também forem lentas, verifique a rede local, a linha e o status do serviço.

Conexão bem-sucedida, mas o cliente não muda

Feche completamente o cliente e abra novamente. Verifique se existem múltiplos arquivos de configuração, variáveis de ambiente antigas que sobrescrevem as novas configurações ou se CC Switch não ativou realmente o fornecedor alvo.

Lista de Verificação Antes do Lançamento

  • Verifique Key, Base URL e modelo com a solicitação mínima.
  • Configure tempo limite, tentativas, simultaneidade e limite de orçamento.
  • Prepare linhas de backup ou modelos de reserva.
  • Faça logs desensibilizados, sem registrar a Key completa.