Modelos de Imagem

O que esta página mostra

Configurações → Modelos de IA é o catálogo de consulta dos modelos ativos no SquadOS. Ele reúne modelos de texto e de imagem, permite buscar por nome, provider ou identificador e mostra capacidades e estimativas de custo.

Essa tela não ativa modelos nem escolhe qual deles um agente usa. A seleção é feita na ferramenta Gerar Imagem com LLM de cada agente. Consulte Gerar Imagem para configurar e validar a entrega.

Acesso e navegação

A rota é /settings/ai-models. A pessoa precisa da capability ai_settings.view para enxergá-la; ai_settings.write não acrescenta controles de ativação nessa página, porque o catálogo é somente leitura.

1. Abra Configurações → Modelos de IA.
2. Selecione o filtro Imagem.
3. Use a busca para localizar um modelo por nome, provider ou slug.
4. Selecione uma linha para abrir os detalhes à direita.

O detalhe confirma nome, provider, tipo Imagem, capacidade Gera imagens, estimativa de custo e slug. Um travessão (—) no custo significa que o catálogo não tem dados suficientes para calcular a estimativa; não significa geração gratuita.

A tela hoje consulta todos os modelos globalmente ativos e não aplica o catálogo do plano nem exclui modelos marcados como indisponíveis no provider. Por isso, Modelos disponíveis não comprova entitlement da organização nem garante que o modelo ainda responderá. Confirme o modelo no contrato do plano e valide-o em uma conversa de teste antes de publicar.

Como ler o preço exibido

O mesmo cartão muda conforme a organização usa ou não uma chave OpenRouter própria:

Situação	Rótulo da tela	O que o número representa
Chave da plataforma	Créditos/Imagem (est.)	estimativa para uma geração padrão 1:1, calculada com os dados locais do modelo
Chave própria (BYOK)	Preço por imagem e Preço do provider	estimativa em USD do custo cobrado diretamente na conta OpenRouter da organização

O preço pode ser conhecido por imagem, por megapixel ou por tokens de saída de imagem. Para modelos baseados em tokens, a prévia usa uma medição de referência armazenada no catálogo. Se o provider ainda não publicou preço ou a medição não existe, a tela mostra —.

Não copie os nomes ou valores para uma regra permanente: o catálogo e os preços podem mudar, e o valor exibido é uma prévia, não a fatura do turno.

Como a cobrança real funciona

Quando o agente gera uma imagem, o backend pede ao OpenRouter o custo real da chamada. Esse valor tem prioridade; a tabela local só é usada como fallback quando o provider não devolve custo.

Com a chave da plataforma, os custos da geração, do texto e de outras imagens da mesma resposta são somados e registrados em uma única linha vinculada à mensagem do assistente. A conversão usa o custo total em USD:

créditos = arredondar_para_cima_2_casas((custo_total_usd × 2000) + 1)

O +1 é aplicado à resposta contabilizada, não separadamente a cada imagem. Por isso, a estimativa Créditos/Imagem pode não coincidir com o débito final de uma resposta que também gerou texto ou mais de uma imagem.

Com BYOK, o OpenRouter cobra o custo do modelo diretamente da chave da organização. O SquadOS registra a resposta em modo byok e desconta 1 crédito operacional por resposta contabilizada, mesmo quando essa resposta contém uma ou mais gerações. O preço em USD mostrado no catálogo não é esse crédito operacional.

Proporção, tamanho e qualidade

A ferramenta nativa aceita 1:1, 16:9, 9:16, 4:3 e 3:4; 1:1 é o padrão. O produto envia a proporção ao provider, mas não oferece um seletor de resolução 1K, 2K ou 4K nessa ferramenta. Não prometa uma resolução específica nem oriente a aumentar para 2K/4K pela interface atual.

Nos modelos cobrados por megapixel, o backend usa uma aproximação próxima de um megapixel para cada uma dessas cinco proporções. A prévia da tela ainda não aplica esse multiplicador e arredonda para crédito inteiro, enquanto o débito real usa duas casas decimais. Trate a prévia como ordem de grandeza.

Como escolher e validar

1. Compare as estimativas no catálogo e comece por um modelo econômico durante a construção do prompt.
2. Confirme com o responsável pelo plano que o modelo faz parte do entitlement da organização.
3. No agente, selecione o modelo em Ferramentas → Gerar Imagem com LLM.
4. Teste pedidos reais, texto dentro da imagem e todas as proporções necessárias.
5. Confirme a imagem na resposta e acompanhe o saldo em Configurações → Assinatura; com BYOK, confira também a conta OpenRouter.

Se o modelo falhar ou desaparecer do provider, escolha outro modelo permitido e teste novamente. Não trate uma nova geração como retry gratuito: o provider pode ter processado a tentativa anterior mesmo quando a entrega falhou.