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.

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:
modeleprompt: o prompt pode ter até 4.000 caracteres.sizeequality: formato e qualidade dentro dos limites do modelo. Sem indicação, valesquaree, no modelo da OpenAI,low.n: quantidade de imagens, no momento apenas1.response_format:url(padrão) traz um endereço de download,b64_jsontraz 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, eparamindica 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_quotaou429 spend_limit_exceeded: o saldo ou o limite de gastos não é suficiente.503 image_model_unavailable,503 image_pricing_unavailableou503 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_readyou409 image_not_deletable: o status atual não permite a ação.