Um prompt, uma imagem.
Você envia um prompt para POST /v1/images/generations e recebe a imagem na mesma resposta, como link ou em Base64. A chamada segue o formato da OpenAI.
Estes modelos estão disponíveis.
A tabela lê o mesmo catálogo da página de preços. Preços em euros por imagem, a partir do tamanho e da qualidade mais baratos.
| Modelo | Tamanhos | Qualidade | Edição | A partir de€ por imagem |
|---|---|---|---|---|
google/gemini-3.1-flash-image
Google
|
square, portrait, landscape, 2k |
medium |
não | 0,0809 |
google/gemini-nano-banana-2.1
Google
|
square, portrait, landscape, 2k |
medium |
não | 0,0626 |
ionos/black-forest-labs/FLUX.2-klein-4B
IONOS
|
square, portrait, landscape, 2k |
medium |
sim | 0,0159 Edição a partir de 0,0171 |
minimax/h3-image
MiniMax
|
square, portrait, landscape, 2k |
medium |
sim | 0,0296 Edição a partir de 0,0365 |
minimax/h3-image-highspeed
MiniMax
|
square, portrait, landscape, 2k |
medium |
sim | 0,0444 Edição a partir de 0,0592 |
openai/gpt-image-2.6-sunburst
OpenAI
|
square, portrait, landscape, 2k |
low, medium |
sim | 0,0376 Edição a partir de 0,0513 |
Tamanhos por nome, não por pixels.
No campo size você indica um dos quatro tamanhos. Quais um modelo aceita está na tabela acima.
square- quadrado
portrait- vertical
landscape- horizontal
2k- horizontal, em resolução maior
Um preço fixo por imagem.
Antes da chamada, o FlowModels reserva o preço da imagem. A cobrança acontece assim que a imagem fica armazenada. Se a geração falhar, a reserva é liberada e você não paga nada.
- Uma imagem por requisição
- Cada requisição gera exatamente uma imagem,
nprecisa ser 1. - Edição
POST /v1/images/editsaltera uma imagem existente, se o modelo aceitar edições. A imagem vem comoimage_urlouimage_file_id, em JPEG, PNG ou WebP, até 10 MiB.- Retenção
- As imagens ficam disponíveis por 7 dias.
GET /v1/images/{id}/contentredireciona para um link de download válido por 15 minutos, e comDELETE /v1/images/{id}você exclui antes.
Requisição e resposta.
Com response_format você escolhe entre url e b64_json. A resposta traz o ID da imagem, com o qual você a busca de novo depois.
curl https://api.flowmodels.one/v1/images/generations \
-H "Authorization: Bearer $FLOWMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemini-3.1-flash-image",
"prompt": "Uma mesa de jantar de carvalho em uma oficina clara",
"size": "landscape",
"response_format": "url"
}'
{
"id": "018fa123-4567-7abc-9def-0123456789ab",
"object": "image",
"created": 1794560400,
"model": "google/gemini-3.1-flash-image",
"status": "completed",
"data": [
{ "url": "https://api.flowmodels.one/v1/images/018fa123-4567-7abc-9def-0123456789ab/content" }
],
"content_type": "image/png",
"expires_at": "2026-11-20T10:00:00+01:00",
"flowai_request_id": "01HXYZ8M3F6V2KQ"
}
| Código de erro | Significado |
|---|---|
422 image_content_rejected |
A imagem foi recusada por causa do conteúdo. |
422 image_request_rejected |
O modelo recusou a requisição. |
503 image_provider_unavailable |
O modelo não está acessível no momento. A reserva é liberada. |
503 image_pricing_unavailable |
Não há preço para esta configuração no momento. Nada é cobrado. |
Teste primeiro no painel.
Em Imagens você testa prompt, tamanho e qualidade, vê o preço por imagem antes de começar e encontra suas últimas imagens em uma galeria. A cobrança passa pela chave de API escolhida.