Dê aos fluxos do Activepieces um provedor de IA compatível com OpenAI.

Resposta rápida: uma entrada de provedor na configuração de IA do admin.

No console de admin do Activepieces, abra a página de configuração de IA e adicione um provedor do tipo OpenAI Compatible. O formulário pede um Display Name, uma API Key, uma Base URL, um API Key Header, headers padrão opcionais, e uma lista de modelos onde cada entrada tem um Model ID, um Model Name, e um Model Type. Os valores para a APIsRouter: Base URL é https://api.apisrouter.com/v1 (o mesmo formato que o próprio código usa para seus provedores compatíveis nativos), API Key Header é Authorization, e o campo da chave recebe sua chave do gateway. Um detalhe de implementação que vale conhecer: o Activepieces envia a chave nesse header exatamente como você digitou, sem adicionar o prefixo Bearer automaticamente, então digite-a como "Bearer sk-..." para a forma canônica; a APIsRouter também aceita a chave nua no header Authorization, então qualquer uma das duas formas funciona aqui. Depois adicione cada modelo que você quer que os fluxos vejam, com o Model ID correspondendo exatamente ao catálogo.

Admin Console -> AI setup -> Add AI Provider
  -> OpenAI Compatible

Display Name:   APIsRouter
Base URL:       https://api.apisrouter.com/v1
API Key Header: Authorization
API Key:        Bearer sk-YOUR-APISROUTER-KEY

Models (Add Model):
  Model ID: claude-haiku-4-5-20251001  Type: TEXT
  Model ID: deepseek-v4-flash          Type: TEXT
  Model ID: claude-sonnet-4-6          Type: TEXT

Como o Activepieces usa um provedor personalizado.

O Activepieces (cerca de 23 mil estrelas no GitHub) é a principal plataforma de automação no-code open-source: fluxos montados a partir de triggers e pieces, no formato do Zapier mas auto-hospedável, com um framework de pieces sob licença MIT e um grande catálogo da comunidade. Seus recursos de IA (etapas de geração de texto, agentes, pieces utilitários de IA) resolvem seu modelo pelos provedores de IA configurados na plataforma, o que faz da entrada de provedor uma decisão de roteamento para todo fluxo de uma vez. Por baixo dos panos, o provedor OpenAI Compatible monta um cliente padrão contra sua Base URL e anexa sua chave sob o nome de header que você escolheu, mais headers de metadados por execução que identificam o projeto e o fluxo. O Model ID que você registrou é passado como a string do modelo nas requisições de chat-completions. Não há auto-descoberta de modelos para esse tipo de provedor: os fluxos só podem selecionar os modelos que você adicionou à lista, o que mantém o seletor intencional em vez de inundado. A configuração do provedor é no nível da plataforma. Um admin a define uma vez, e todo projeto e fluxo na instância seleciona a partir dos modelos registrados. Essa centralização é o ganho de governança: um único lugar para decidir quais modelos existem, uma chave para medir todas as etapas de IA, e os metadados por fluxo em cada requisição tornando o uso atribuível quando você lê os logs.

Configuração completa e a ressalva no momento de salvar.

O formulário salva sem validar a conexão; a implementação do provedor pula deliberadamente as checagens de conexão para o tipo OpenAI Compatible. Isso é conveniente (nenhuma sondagem do seu endpoint no momento de salvar), mas significa que uma Base URL errada ou uma chave malformada falha depois, na primeira execução de fluxo que toca uma etapa de IA. Verifique o endpoint manualmente uma vez antes de conectá-lo a fluxos de produção, e trate a primeira execução como parte da configuração. O Model Type importa para quais pieces podem usar a entrada: etapas de texto querem modelos TEXT. Registre o id exatamente como o catálogo o soletra; o Model Name é um rótulo de exibição e pode ser qualquer coisa legível. Se você quiser o mesmo modelo subjacente em dois níveis de preço-desempenho para times diferentes, registre-o uma vez por Model ID; os nomes de exibição os mantêm distinguíveis no seletor.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Escolhendo modelos para etapas de automação.

Como o provedor é de toda a plataforma, a governança de modelos é uma única tela: adicione os ids que você aprova, observe uma semana de uso por chave, e pode o que ninguém deveria usar. Os criadores de fluxo mantêm sua liberdade dentro da lista que você curou.

• IA de automação é trabalho de alto volume e prompt curto: classificar um ticket, extrair campos, rascunhar uma mensagem, resumir um payload de webhook. claude-haiku-4-5-20251001, gpt-5.4-mini e deepseek-v4-flash cobrem a maioria das etapas com preço de volume.
• Reserve um id mais forte para etapas de julgamento. Um fluxo que rascunha respostas voltadas ao cliente ou toma decisões de roteamento merece claude-sonnet-4-6, selecionado por etapa no construtor de fluxos.
• MiniMax-M2.7 e a família DeepSeek têm preço extremamente bom para fluxos de transformação em massa (feeds, limpeza de scraping, enriquecimento) onde milhares de execuções por dia são normais.
• Fluxos rodam sem supervisão, então o custo é uma agenda multiplicada por uma contagem de tokens por execução. O log de uso te dá o número por execução; a agenda é sua.
• Registre poucos modelos, de propósito. O seletor mostra exatamente o que você adicionou, e uma lista curada evita que uma centena de criadores de fluxo escolham cada um de um jeito diferente.

Pague pelo uso · abaixo do preço oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modos de falha específicos do Activepieces.

Salvamento silencioso, primeira execução barulhenta. Como o provedor OpenAI Compatible pula a validação de conexão, todo erro de conexão (Base URL errada, /v1 faltando, chave malformada, nome de header errado) aparece como uma etapa de IA falha em uma execução de fluxo em vez de um erro de formulário. Quando uma etapa de IA falha logo após mudanças no provedor, suspeite da entrada do provedor antes do fluxo. A questão do prefixo Bearer. A chave é enviada literalmente sob o header que você escolheu. Endpoints que exigem o prefixo Bearer literal precisam dele digitado no campo da chave; a APIsRouter aceita as duas formas, mas se você algum dia reapontar esse provedor para outro lugar, lembre que a plataforma não vai adicionar o prefixo por você. Model IDs são exatos. Um id registrado com um erro de digitação passa pelo formulário (os rótulos são texto livre) e falha em tempo de execução com model-not-found; a saída de /v1/models do gateway é a grafia autoritativa. Nenhuma auto-descoberta é um recurso, não um bug. Se um modelo está faltando no seletor de um fluxo, ele não foi registrado no provedor; adicione-o no console de admin em vez de procurar no construtor de fluxos. E mantenha as conexões em nível de piece separadas na sua cabeça: pieces individuais como o piece do OpenAI podem ter suas próprias credenciais por conexão, enquanto a entrada de provedor descrita aqui alimenta os recursos universais de IA da plataforma. Se um fluxo usa um piece específico de fornecedor com sua própria conexão, esse tráfego não passa pela sua entrada de gateway.

Quem roteia o Activepieces por um gateway.

• Times de auto-hospedagem padronizando IA em dezenas de fluxos, onde uma entrada de provedor e uma chave substituem credenciais espalhadas por piece.
• Admins de plataforma que querem governança de modelos: uma lista de modelos curada, uso por chave, e a capacidade de trocar o endpoint por trás sem tocar nos fluxos.
• Agências rodando automações de clientes em uma instância, medindo o uso de IA por cliente com chaves separadas no mesmo catálogo.
• Criadores cujos fluxos misturam etapas de volume e etapas de julgamento, combinando ids rápidos com ids de ponta por etapa através de um endpoint.
• Desenvolvedores sem acesso ao faturamento de um determinado fornecedor. O acesso baseado em recarga sem exigência de cartão remove a dependência de cadastro por provedor.

Verifique o endpoint e depure a primeira etapa de IA.

Rode os dois curls acima antes de salvar o provedor; eles comprovam a chave, a Base URL e o id do modelo juntos, exatamente o que o formulário não vai checar por você. Quando a etapa de IA de um fluxo falha depois da configuração, leia o erro da etapa. Falhas de autenticação significam que o campo da chave ou o nome do header está errado (ou o prefixo Bearer está faltando em um endpoint que o exige). Um erro model-not-found é um id registrado que não corresponde ao catálogo. Um erro de conexão geralmente significa que a Base URL perdeu seu /v1. Se a etapa não consegue encontrar nenhum modelo para selecionar, o provedor salvou mas a lista de modelos está vazia para aquele tipo de modelo. Assim que os fluxos rodam, o console da APIsRouter mostra modelo, contagens de token e gasto por requisição. Automações agendadas se acumulam silenciosamente, e a visão de uso por chave é como um admin de plataforma vê quais fluxos merecem seus tokens antes da fatura.

Perguntas frequentes