FlowModels

Primeiros passos com o FlowModels

Publicado em 11. novembro 2026

Com o FlowModels, você integra modelos de IA da OpenAI, Anthropic, Google Gemini, xAI e outros provedores diretamente na sua própria aplicação. Para isso, você não precisa de uma assinatura da FlowSuite: a API tem saldo próprio em euros e é cobrada por consumo. Em três passos, você chega à primeira chamada.

O FlowModels é destinado exclusivamente a empresas e profissionais autônomos. Por isso, em cada recarga manual e ao configurar a recarga automática, você confirma que usa o FlowModels para fins empresariais ou de atividade profissional autônoma.

Abrir o dashboard

Entre em flowmodels.one/dashboard. Se ainda não tiver uma conta, crie uma em flowmodels.one, em Criar conta. Como proprietário da equipe, você tem acesso automaticamente. Os demais membros da equipe precisam de uma liberação própria, que você concede em Equipe.

Enquanto sua equipe nunca tiver chamado a API, a Visão geral mostra o quadro Três passos até a primeira chamada.

O dashboard com os passos até a primeira chamada e os indicadores do mês

Passo 1: criar uma chave

Clique em Criar uma chave. Para chamadas de modelo, escolha a permissão Usar IA, dê um nome à chave e crie. A chave completa é exibida uma única vez, então copie na hora. Todas as configurações estão em Criar chaves de API: permissão, limite e validade.

Passo 2: recarregar o saldo

Sem saldo disponível, a API recusa qualquer chamada de modelo. Clique em Adicionar saldo e, em Faturamento, faça uma recarga de no mínimo 20 €. Como isso funciona em detalhes está em Recarregar saldo e ativar a recarga automática.

Passo 3: enviar a primeira chamada

A API é compatível com o formato Chat Completions da OpenAI. Por isso, muitas bibliotecas existentes funcionam quando você troca o endereço base e a chave. Uma chamada mínima com curl é assim:

curl https://api.flowmodels.one/v1/chat/completions \
  -H "Authorization: Bearer at_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-5.6-luna", "messages": [{"role": "user", "content": "Olá"}]}'

Substitua at_sua_chave pela sua chave. A chave é sempre enviada no cabeçalho Authorization: Bearer, nunca como parâmetro de URL ou no corpo da requisição.

O modelo é informado pelo identificador completo de provedor e modelo, por exemplo openai/gpt-5.6-luna. Quais modelos estão liberados e quanto custam, você vê em Modelos, veja Modelos e preços do FlowModels. A lista também pode ser obtida com GET /v1/models.

Depois da primeira chamada

Assim que sua equipe tiver usado a API, a Visão geral mostra, no lugar dos três passos, os indicadores do mês em curso: Chamadas de modelo, Gastos de roteamento, o valor Disponível e Reservas em aberto. Abaixo, você vê chamadas e custos dos últimos 30 dias em um gráfico.

Bom saber

  • A documentação técnica completa, com todos os endpoints, está em Documentação na barra lateral ou diretamente em flowmodels.one/pt/docs.
  • Sua assinatura do FlowAI para o chat na FlowSuite continua separada. O FlowModels tem chaves próprias, saldo próprio e faturas próprias, veja FlowModels ou chat do FlowAI.
  • Em caso de erro, guarde o flowai_request_id da resposta. Com ele, o suporte consegue identificar sua requisição sem dúvida. Mais detalhes em Entender as mensagens de erro do FlowModels.

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API