Conecte e gerencie seus provedores de modelos de IA
Por padrão, a Timely.ai usa créditos gerenciados pela plataforma para rodar os modelos de linguagem. Ao conectar uma chave própria de provedor, os agentes do workspace passam a usar suas credenciais — aproveitando seus contratos de volume e limites de rate privados. Provedores configurados ficam disponíveis para todos os agentes do workspace.
OpenAI (GPT-5.1, GPT-5.2, etc.)
Acesse platform.openai.com/api-keys
Faça login na sua conta OpenAI e acesse a seção de chaves de API.
Crie uma nova chave
Clique em Create new secret key. Dê um nome descritivo (ex.: “Timely.ai Produção”) para identificar a origem das chamadas.
Copie a chave
Copie a chave imediatamente — ela não será exibida novamente após fechar o modal.
Acesse Configurações > Provedores na Timely.ai
No menu lateral, clique em Configurações e selecione a subseção Provedores.
Clique em Adicionar provedor e selecione OpenAI
Preencha o nome interno, selecione o tipo OpenAI e cole a chave no campo correspondente.
Salve e valide
Clique em Validar chave para confirmar que as credenciais estão funcionando. Com a validação positiva, clique em Salvar.
Chaves OpenAI começam com sk-. Verifique se a organização associada à chave tem acesso aos modelos GPT-5.1 e GPT-5.2 — modelos novos exigem aprovação de acesso no painel da OpenAI.
Anthropic (Claude)
Acesse console.anthropic.com/settings/keys
Faça login na sua conta Anthropic e vá até a seção de chaves.
Crie uma nova chave de API
Clique em Create Key. Defina um nome que identifique o uso (ex.: “Timely Workspace”).
Copie a chave
A chave tem o prefixo sk-ant-. Copie antes de fechar o modal.
Acesse Configurações > Provedores na Timely.ai
Navegue até a subseção Provedores em Configurações.
Adicione o provedor Anthropic
Selecione o tipo Anthropic, nomeie o provedor e cole a chave.
Salve e valide
Clique em Validar e, com confirmação positiva, em Salvar. Modelos disponíveis: Claude Haiku 4.5 (3 créditos), Claude Sonnet 4.6 (4 créditos) e Claude Opus 4.6 (20 créditos).
Garanta que a conta Anthropic tem saldo de API suficiente. Chaves de contas sem crédito retornam erro 429 mesmo com a chave válida.
Google Gemini (Google AI Studio)
Acesse aistudio.google.com/app/apikey
Faça login com sua conta Google e vá até a seção de chaves de API do Google AI Studio.
Crie uma chave para o projeto desejado
Selecione o projeto Google Cloud associado e clique em Create API key.
Copie a chave
Chaves do Google AI começam com AI. Copie antes de sair da tela.
Acesse Configurações > Provedores na Timely.ai
Navegue até a subseção Provedores.
Adicione o provedor Google
Selecione o tipo Google, nomeie e cole a chave.
Salve e valide
Valide e salve. Modelos disponíveis: Gemini 2.5 Flash (2 créditos), Gemini 2.5 Pro (4 créditos), Gemini 3.0 Pro Preview (6 créditos) e Gemini 3.1 Pro Preview (6 créditos).
OpenRouter (Em breve)
Acesse openrouter.ai/keys
Faça login na sua conta OpenRouter e vá até a seção de chaves de API.
Crie uma nova chave
Clique em Create Key e dê um nome descritivo.
Copie a chave
Chaves OpenRouter começam com sk-or-. Copie antes de fechar o modal.
Acesse Configurações > Provedores na Timely.ai
Navegue até a subseção Provedores.
Adicione o provedor OpenRouter
Selecione o tipo OpenRouter, nomeie e cole a chave.
Salve e valide
Valide e salve. Modelo disponível via OpenRouter: Kimi K2.5 da Moonshot AI (1 crédito por mensagem — melhor custo-benefício do catálogo).
A integração com OpenRouter está em fase de liberação gradual. Se o tipo ainda não aparecer no seletor de provedores, o acesso ainda não foi liberado para o seu workspace.
Como configurar o provedor dentro da Timely.ai
Após criar a chave no painel do provedor, você tem duas formas de registrá-la na plataforma. Ambas têm o mesmo resultado — escolha a que for mais conveniente para o seu fluxo.
Opção 1: Pela página principal do workspace
Acesse Configurações
No menu lateral, clique em Configurações.
Abra a subseção Provedores
Selecione Provedores na lista de subseções disponíveis.
Clique em Adicionar provedor
O formulário de cadastro é exibido na tela.
Opção 2: Pela página de um agente
Acesse o painel do agente
Abra o agente desejado em Agentes de IA.
Localize o seletor de provedor e modelo
Na seção de configurações do agente, clique em Provedor de LLM.
Selecione ou adicione um provedor
Se o provedor desejado não estiver listado, clique em Adicionar novo provedor para abrir o mesmo formulário de cadastro.
Configurar o provedor
Com o formulário aberto — seja pela página de workspace ou pela página do agente — siga estas etapas:
Preencha o nome interno
Use um nome que identifique o uso (ex.: “OpenAI Produção”, “Anthropic Testes”). Esse nome aparece nos seletores de agente.
Selecione o tipo de provedor
Escolha entre OpenAI, Anthropic, Google ou OpenRouter.
Cole a chave de API
O campo mascara os caracteres após a inserção por segurança.
Valide a chave
Clique em Validar chave. A plataforma faz uma chamada de teste ao provedor e exibe o resultado imediatamente — válida (verde) ou inválida (vermelho com a mensagem de erro do provedor).
Salve o provedor
Com validação positiva, clique em Salvar. O provedor aparece na lista com um indicador de status e fica disponível para seleção nos agentes do workspace.
