Conectar um provedor de IA

Atualizado em 11 de out. de 2026 · 3 min de leitura

As tags por IA rodam em um provedor que você escolhe: a sua própria chave da OpenRouter, da OpenAI, da Anthropic ou do Google Gemini, o Ollama neste computador, ou o seu plano do ChatGPT via Codex.

As descrições, as tags e a busca semântica por IA do Meshory são opcionais, e não existe assinatura de IA do Meshory. Você escolhe quem faz o trabalho em Settings → AI tagging, que tem dois grupos, Descriptions and tags e Semantic search, cada um com o seu próprio provedor. Um provedor que você acessa com uma chave de API cobra de você diretamente, por uso; o Ollama roda no seu próprio computador; e o Codex CLI roda no seu plano do ChatGPT.

Qual provedor escolher

• OpenRouter: uma única chave dá acesso a modelos de todos os principais provedores. É a opção padrão e, no Meshory 1.11.0, o único provedor com o qual a busca semântica funciona.
• API da OpenAI, API da Anthropic ou API do Google Gemini: uma chave do console de desenvolvedor da empresa, com cobrança feita por ela por uso. A cobrança da API é separada de uma assinatura do app ChatGPT ou Claude.
• Ollama: roda um modelo neste computador, sem chave e sem cobrança. O Meshory se conecta ao servidor do Ollama neste computador na porta que você definir, e você mesmo instala o modelo no Ollama; o Meshory nunca baixa um.
• Codex CLI: usa a sua assinatura do ChatGPT por meio da ferramenta de linha de comando Codex, da OpenAI, instalada neste computador e com login feito no ChatGPT. Cada execução conta para os limites de uso do Codex do seu plano, e o Meshory nunca vê o seu login.

Obtenha uma chave na OpenRouter

1. 1Cadastre-se em openrouter.ai. Uma única conta dá acesso a modelos de todos os principais provedores.
2. 2Adicione alguns dólares de crédito na página Credits. A OpenRouter é pré-paga, então você nunca gasta mais do que carregou.
3. 3Crie uma chave em openrouter.ai/keys, dê a ela um nome como “Meshory” e copie-a. Ela começa com sk-or-. Você pode definir um limite de gastos próprio para a chave, como proteção extra.

Adicione uma chave ao Meshory

1. 1Abra Settings → AI tagging e, em Descriptions and tags, escolha o provedor.
2. 2Cole a chave no campo API key dela e clique em Save. Ela fica guardada criptografada pelo chaveiro do sistema, e o campo mostra Key saved no lugar da chave.
3. 3Escolha um Generation model e depois clique em Test descriptions and tags. Generation connection OK significa que está tudo pronto.
4. 4Para a busca semântica, escolha OpenRouter em Semantic search. Ela usa a chave que você salvou acima; clique em Test semantic search para conferir.

Ollama neste computador

Instale primeiro o Ollama e um modelo nele: o Meshory lista os modelos já instalados e nunca baixa nenhum. Escolha Ollama como provedor, mude a porta se você tiver tirado o Ollama do padrão dele, 11434, clique em Refresh installed models, escolha um modelo e teste-o. Não mexa nesse modelo enquanto o Meshory estiver trabalhando: se ele mudar, o trabalho para até você testar de novo.

Codex CLI com o seu plano do ChatGPT

Instale o Codex CLI com npm install -g @openai/codex, execute codex login em um terminal e entre com o ChatGPT, depois escolha Codex CLI como provedor. O Meshory encontra o Codex instalado neste computador e diz o que está faltando quando não consegue executá-lo. Generation model começa em Codex default, que deixa o Codex escolher; modelos maiores usam mais do seu plano a cada execução.

Como executar

A partir daí, rode a geração de tags na biblioteca inteira, em uma pasta ou em uma seleção, quando quiser. O menu de IA na barra de ferramentas da biblioteca mostra o provedor e o modelo, quanto vai custar processar arquivos novos (em dólares, grátis neste computador ou em execuções do Codex) e um registro de requisições com o status em tempo real. Se uma execução falhar de imediato, teste a conexão de novo e confirme que uma conta paga tem crédito.