A PandaNpc armazena conexões de provedores e entradas de modelos que você configura. Comece com a Chave de API, URL Base, protocolo e ID do modelo fornecidos pelo seu serviço. Adicionar uma entrada não cria uma conta upstream nem concede acesso ao modelo.
Para a distinção entre um provedor e um modelo, leia Gerenciar sua lista de modelos personalizados.
Antes de começar
Confirme o seguinte com seu provedor ou serviço auto-hospedado:
- O endereço base da API, não o endereço do site do provedor.
- O método de autenticação e quaisquer credenciais necessárias.
- O protocolo de API suportado pelo recurso ou mecanismo que você pretende usar.
- O ID exato do modelo que sua conta pode chamar.
- Limites de contexto e saída, se você planeja inseri-los manualmente.
Mantenha as credenciais no formulário do provedor, não em prompts, capturas de tela ou notas compartilhadas. Um serviço anunciado como compatível com OpenAI ainda pode diferir em streaming, chamadas de ferramentas ou suporte a imagens.
1. Adicionar ou configurar um provedor
Abra Configuração de Modelo. Adicione um provedor, configure um preset existente ou copie um preset quando precisar de uma conexão editável independentemente.
| Campo | O que inserir |
|---|---|
| Nome de Exibição | Um nome reconhecível para esta conexão |
| ID do Provedor | Um identificador para a configuração do provedor |
| Chave de API | A credencial exigida pelo seu serviço |
| URL Base | O endereço base da API esperado pela integração escolhida |
| Protocolo | O formato que a API upstream realmente implementa |
| Segredo, Organização, Projeto | Apenas valores explicitamente exigidos pelo seu serviço |
| Suporte a array de conteúdo | Se o serviço aceita conteúdo de mensagem estruturado |
A forma da URL Base depende do protocolo e do recurso que faz as solicitações. Não acrescente um caminho de operação completo se a integração já o acrescenta. Por exemplo, uma integração que adiciona /chat/completions precisa do endereço base correspondente, não de um endereço que já termina com esse caminho. Não aplique esse exemplo a todos os protocolos.
Ao editar credenciais armazenadas, deixar a Chave de API ou o Segredo em branco preserva o valor configurado. Um valor mascarado mostrado em uma lista não é a chave original e não deve ser colado de volta como substituto.
2. Adicionar o modelo
Salve o provedor, selecione-o e escolha Adicionar Modelo.
| Campo | Significado |
|---|---|
| Nome de Exibição | Seu rótulo na lista de modelos |
| Valor do Modelo | O ID exato do modelo upstream |
| Tipo de Modelo | A categoria aplicável no formulário de configuração |
| Provedor | A conexão que esta entrada usa |
| Janela de Contexto | A capacidade de contexto documentada, quando especificada |
| Máx. de Tokens | O limite de saída, quando especificado |
Use um ID da documentação do serviço ou da lista de modelos. Um nome comercial não é necessariamente um identificador de API. Deixe limites opcionais não definidos se você não puder verificá-los; não definido não significa que os limites reais foram detectados. O recurso consumidor pode aplicar seus próprios padrões.
3. Verificar a configuração
No recurso ou mecanismo que usa essas configurações:
- Selecione a nova entrada e inicie uma conversa de teste.
- Envie uma solicitação curta como
Responda com: conectado. - Confirme uma resposta normal e, quando disponível, uma solicitação correspondente nos registros de uso do provedor.
- Envie uma continuação para verificar a conversa contínua.
- Teste imagens ou chamadas de ferramentas separadamente se seu trabalho exigir isso.
Salvar o registro não é um teste de conexão. Uma resposta de texto não estabelece compatibilidade com todos os recursos. Alterar uma entrada de modelo também não reconfigura automaticamente um processo existente de Claude Code ou Codex; veja PandaPaw.
Solução de problemas
A autenticação falha
Verifique se a chave está ativa, se a conta pode acessar o modelo e se o serviço exige campos de autenticação adicionais. Substitua credenciais expiradas pelo formulário do provedor.
O endpoint ou modelo não foi encontrado
Verifique tanto a URL Base quanto o Valor do Modelo. Procure por caminhos de operação duplicados, um prefixo de API ausente ou um ID de modelo indisponível para sua conta. O mesmo erro pode ter causas diferentes entre provedores.
Aparece um erro de rede ou navegador
Verifique a conectividade do dispositivo que realmente envia a solicitação. Solicitações originadas no navegador estão sujeitas a restrições de CORS e HTTPS; uma solicitação funcionando de outro computador não prova que o caminho do navegador funciona.
Não é possível alcançar um servidor de modelo local
localhost refere-se à máquina que faz a solicitação. Ele não aponta automaticamente para o seu computador PandaPaw remoto. Confirme onde o recurso consumidor é executado antes de escolher o endereço do seu servidor local.
O texto funciona, mas imagens, ferramentas ou sessões longas falham
Verifique a combinação exata de mecanismo, protocolo de API e capacidades do modelo. Use limites suportados pelo provedor e verifique cada tipo de entrada necessário. Aumentar a Janela de Contexto ou alterar o Tipo de Modelo não adiciona capacidades upstream.
Para a distinção entre associação à plataforma e uso de provedor, veja contas e custos de modelos.