Conecte um provedor de modelos
Preencha tipo de API, endpoint, chave de API e ID do modelo, veja como o Yenpo monta a URL e resolva erros comuns de conexão.
O AI Reader usa o provedor selecionado em Settings. Sua conta no provedor determina quais modelos você pode usar e quanto paga. Ler e pesquisar arquivos não exige essa conexão.
Adicione um provedor
Abra Settings → Models, clique em Add Provider (o botão de mais) e selecione a nova entrada como Current provider. Dê um nome reconhecível, como “Gateway da equipe”. O nome é apenas um rótulo e não afeta a API usada.
Depois preencha:
| Campo | O que informar |
|---|---|
| API type | O protocolo usado pelo serviço: OpenAI Chat Completions, OpenAI Responses ou Anthropic Messages |
| Endpoint | A URL do serviço, incluindo o prefixo de caminho exigido pelo gateway |
| Authentication / API key | Sua chave de API ou a opção de login oferecida pelo provedor |
| Model | O ID exato de um modelo disponível para sua conta |
Insira chaves de API apenas em Settings, nunca em uma conversa ou arquivo de projeto. Alguns provedores oferecem login por conta em vez de chave; nesse caso, selecione-o em Sign-in method.
Combine o endpoint com o tipo de API
O nome do modelo não identifica o protocolo: um gateway pode oferecer nomes parecidos por APIs diferentes. Siga a documentação da API do serviço e mantenha os prefixos de caminho exigidos.
Estas URLs mostram como o Yenpo monta a requisição. São exemplos, não serviços em funcionamento:
| Tipo de API | Exemplo no campo Endpoint | URL da requisição resultante |
|---|---|---|
| Chat Completions | https://gateway.example/v1 |
https://gateway.example/v1/chat/completions |
| Responses | https://gateway.example |
https://gateway.example/v1/responses |
| Messages | https://gateway.example |
https://gateway.example/v1/messages |
Se o endpoint já termina em /chat/completions, /responses ou /messages, o Yenpo o usa como está para o tipo correspondente. Em Responses e Messages, o último segmento é adicionado a endpoints que terminam em /v1. Chat Completions sempre acrescenta /chat/completions ao que você informou e não adiciona um /v1 ausente.
Se ocorrer um erro, não alterne tipos de API até ele desaparecer. Descubra o protocolo aceito pelo serviço e o caminho completo esperado.
ID do modelo
Digite o ID em Model ou clique em Fetch List se o serviço publicar uma lista de modelos. Buscar a lista e chamar o modelo são requisições separadas, então o modelo pode funcionar mesmo quando a busca falha. Tente informar diretamente o ID documentado.
Context length afeta os limites de entrada e saída do Yenpo, o momento de compactar a conversa e quanto contexto permanece depois. Informe o limite documentado do modelo; em branco, o Yenpo usa o padrão. Um valor pequeno demais pode provocar compactações desnecessárias; grande demais, requisições rejeitadas pelo modelo.
Pricing calcula o custo estimado exibido nos detalhes da execução. Use as tarifas do provedor; esses valores não alteram as cobranças reais nem concedem acesso a modelos. Enquanto configura a primeira conexão, mantenha as demais opções como estão.
A entrada de imagens vem desativada para cada provedor. Ative Accept images apenas se o modelo e a API aceitarem as imagens que pretende enviar.
Teste com uma pergunta pequena
Abra um arquivo pequeno que você possa enviar ao serviço e pergunte:
O que esta função retorna para uma entrada vazia? Cite a ramificação relevante.
Se chegar uma resposta, a conexão funciona. A correção da resposta é outra questão: confira-a no código.
Uma requisição leva sua mensagem e o código relevante que o AI Reader encontra no projeto, não apenas o texto digitado. Leia Dados, permissão de edição e terminal antes de enviar código confidencial a um endpoint remoto.
Quando uma requisição falha
| Sintoma | O que conferir |
|---|---|
| Erro de autenticação ou permissão | Conta ou chave selecionada, proprietário do endpoint e acesso ao modelo |
| Não encontrado ou API incompatível | Tipo de API e caminho completo da requisição, incluindo prefixos do gateway |
| Modelo não encontrado | ID exato do modelo e disponibilidade para sua conta |
| Fetch Models falha | Se o serviço oferece uma lista; informe diretamente o ID documentado |
| Timeout ou fluxo interrompido | Acesso à rede, comportamento de proxy/gateway e disponibilidade do provedor |
Um status HTTP raramente revela a causa sozinho, e gateways podem reescrever erros recebidos. Ao relatar um problema, inclua mensagem de erro, tipo de API e endpoint sem informações privadas. Nunca inclua a chave de API.
Se uma execução com edições permitidas foi interrompida, confira a árvore de trabalho antes de tentar novamente. Arquivos podem ter mudado mesmo sem uma resposta final.