FlowModels

Gerar e editar imagens: Playground, API, modelos e custos

Publicado em 13. novembro 2026

Com o FlowModels, você gera imagens a partir de uma descrição em texto ou edita uma imagem existente de acordo com o seu prompt. Diferente de um vídeo, uma imagem é criada dentro da própria requisição: você envia o prompt e recebe a imagem pronta na mesma resposta, geralmente em poucos segundos. Isso funciona no Playground do dashboard ou diretamente pela API.

Os modelos

Modelo Formatos Qualidade Edição
openai/gpt-image-2.6-sunburst square, portrait, landscape, 2k low, medium sim
google/gemini-3.1-flash-image square, portrait, landscape, 2k medium não
google/gemini-nano-banana-2.1 square, portrait, landscape, 2k medium não
minimax/h3-image square, portrait, landscape, 2k medium sim
minimax/h3-image-highspeed square, portrait, landscape, 2k medium sim

square é quadrado, portrait vertical, landscape horizontal e 2k um formato horizontal largo em resolução maior. Sem indicação, vale square. Use apenas modelos que aparecem com o tipo image na sua resposta de GET /v1/models. Lá, image traz os formatos, as qualidades e se o modelo pode editar, e pricing.variants traz os preços por imagem. Não há troca automática para outro modelo.

A API continua aceitando o ID anterior google/gemini-3.1-flash-image-preview. O Google desativou esse modelo de pré-visualização, por isso uma solicitação assim é gerada com google/gemini-3.1-flash-image e cobrada pelo preço dele, e a resposta informa esse modelo. O ideal é mudar suas solicitações para o novo ID.

No Playground

No dashboard, abra o Playground e a aba Imagens. Escolha o Modelo, descreva a imagem no campo Prompt e defina Formato e Qualidade. Com modelos que editam (veja a tabela), você também pode enviar uma Imagem a editar (opcional) (JPEG, PNG ou WebP, até 10 MB). Com uma imagem, ela é editada segundo o seu prompt; sem imagem, é criada uma nova.

Antes de iniciar, Preço por imagem mostra quanto custa a sua seleção. Com Gerar imagem, você inicia a geração.

O Playground de imagens com o formulário, o preço por imagem e a galeria

Em As suas imagens aparecem as imagens da sua equipe dos últimos sete dias, inclusive as criadas pela API. Você pode abri-las em tamanho real, baixá-las ou excluí-las. A galeria não mostra prompts, porque toda a equipe pode vê-la. A cobrança é feita no crédito FlowModels da sua equipe, por isso você não precisa de uma chave de API. Em Consumo e Solicitações, as suas chamadas aparecem como "Playground · seu nome".

O que as outras abas do Playground fazem e quais limites valem nelas está em Experimentar modelos no Playground.

Pela API

Uma imagem nova é criada com POST /v1/images/generations:

curl https://api.flowmodels.one/v1/images/generations \
  -H "Authorization: Bearer at_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-image-2.6-sunburst", "prompt": "Um barquinho de papel em um lago calmo ao nascer do sol", "size": "landscape", "quality": "low"}'

Os campos mais importantes:

  • model e prompt: o prompt pode ter até 4.000 caracteres.
  • size e quality: formato e qualidade dentro dos limites do modelo. Sem indicação, vale square e, no modelo da OpenAI, low.
  • n: quantidade de imagens, no momento apenas 1.
  • response_format: url (padrão) traz um endereço de download, b64_json traz a própria imagem em Base64.

Para editar, envie os mesmos campos para POST /v1/images/edits junto com a imagem, como image_url (endereço https ou URL data:) ou como image_file_id de um arquivo de POST /v1/files. São aceitos JPEG, PNG e WebP de até 10 MiB. No momento, só o openai/gpt-image-2.6-sunburst pode editar.

Se o modelo não conhece um campo, a API o recusa com 422 e o nome do campo em param, antes de qualquer reserva. Com um Idempotency-Key, você pode repetir a requisição com segurança depois de um erro de rede, sem que uma segunda imagem seja criada.

Resposta e consulta

A resposta segue a estrutura da API de imagens da OpenAI: created e data com exatamente uma entrada. Ela traz ainda id, status, content_type, size_bytes, expires_at e usage. status é completed quando a imagem está pronta, failed em caso de erro e in_progress enquanto a geração ainda está em andamento.

O endereço em data[0].url aponta para GET /v1/images/{id}/content. Essa chamada precisa da sua chave e responde com 302 para um endereço de download válido por 15 minutos:

curl -L https://api.flowmodels.one/v1/images/{id}/content \
  -H "Authorization: Bearer at_sua_chave" \
  -o imagem.png

Com GET /v1/images/{id}, você consulta uma imagem de novo mais tarde. Não há webhooks para imagens, porque a resposta já traz a imagem pronta.

Retenção

Uma imagem pronta fica disponível por sete dias, e expires_at indica o momento exato. Depois disso, nós a excluímos automaticamente. Com DELETE /v1/images/{id} ou no Playground, você a exclui antes. Guarde do seu lado as imagens de que precisa por mais tempo.

Quanto custa uma imagem

As imagens são cobradas por imagem. O preço depende do modelo, do formato e da qualidade. O preço atual aparece em Modelos e em GET /v1/models, em pricing.variants.

Antes da geração, reservamos o preço de uma imagem. O valor só é debitado quando a imagem está armazenada conosco. Requisições recusadas e com falha não custam nada. O valor cobrado aparece na resposta em usage.cost.

Limites

  • Uma geração ocupa uma das suas vagas de requisições simultâneas, veja Limite de requisições: como funcionam os níveis. Consultas, downloads e exclusões não contam.
  • Cada requisição cria exatamente uma imagem.
  • As imagens geradas são criadas por IA. Identifique-as como tal ao publicá-las.

Quando algo não funciona

  • 422 invalid_image_request: um campo não combina com o modelo, e param indica qual.
  • 422 image_input_invalid: a imagem a editar está faltando, é inválida, grande demais ou não pertence à sua equipe.
  • 422 image_request_rejected: o modelo recusou a requisição. Ajuste o prompt ou as configurações.
  • 422 image_content_rejected: a imagem foi recusada por causa do conteúdo.
  • 429 insufficient_quota ou 429 spend_limit_exceeded: o saldo ou o limite de gastos não é suficiente.
  • 503 image_model_unavailable, 503 image_pricing_unavailable ou 503 image_provider_unavailable: tente de novo mais tarde, seu saldo não foi debitado.
  • 404 image_not_found: o ID é desconhecido, expirou ou não pertence à sua equipe.
  • 409 image_not_ready ou 409 image_not_deletable: o status atual não permite a ação.

Este artigo foi útil?

Voltar para Modelos, limites e erros