gemini-3.1-flash-lite-image API

Use o ID exato do modelo gemini-3.1-flash-lite-image. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídagemini-3.1-flash-lite-imagePOST /v1beta/models/gemini-3.1-flash-lite-image:generateContent

Parâmetros: ratio=16:9

Prompt: A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text.

Solicitação que produziu esta amostra

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9"
    }
  }
}

Autenticação e endpoint

Use uma chave de API Modelflare com https://modelflare.dev. O ponto de entrada do gateway é POST /v1/models/{model}:generateContent.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Gerar uma imagem

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

Solicitar notas

Os modelos de imagem Gemini usam contents e generationConfig nativos; edições enviam a instrução de texto e inline_data no mesmo parts[].

Parâmetros de solicitação

Os modelos de imagem Gemini usam Gemini nativo generateContent. Colocar texto e imagens de referência no mesmo contents[].parts[]; imagens usam inline_data. Não envie esses modelos para /v1/images/generations, /v1/images/edits ou OpenAI /v1/responses. O imageSize enum é específico do modelo e mostrado abaixo.

Campo	Obrigatório	Notas
contents[].parts[].text	Sim	Solicitação de texto ou instrução de edição
contents[].parts[].inline_data	Não	Dados de imagem Base64 e tipo MIME
contents[].parts[].inline_data.mime_type	Não	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	Não	Conteúdo da imagem de referência codificada em Base64
generationConfig.responseModalities	Sim	["IMAGE"] ou ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	Não	1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
generationConfig.imageConfig.imageSize	Não	1K

Limites de resposta e entrada

Lite suporta apenas 1K com 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 e 21:9. A documentação oficial não publica um limite de contagem de imagens de referência, portanto o gateway não adiciona nenhum limite local e retorna o erro de serviço quando o limite de serviço é excedido.

Exemplo de edição de imagem

Coloque a instrução de edição e a imagem de referência no mesmo contents[].parts[]. inline_data.data é o conteúdo da imagem Base64; não envie modelos de imagem Gemini para os endpoints OpenAI Images ou Responses.

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

Forma de resposta

Leitura candidates[].content.parts[]; não presuma que cada parte é uma imagem porque a resposta pode conter partes de texto e imagem juntas.

Campo	Notas
candidates[].content.parts[].inline_data	Tipo MIME de imagem gerada e dados Base64
candidates[].content.parts[].text	Legenda de texto retornada quando TEXT foi solicitado
candidates[].finishReason	Conclusão ou motivo de segurança
usageMetadata	Uso de token de entrada/saída quando retornado pelo serviço

Modelflare preserva o formato de resposta nativo do Gemini para gemini-3.1-flash-lite-image e persiste partes de imagem utilizáveis.

Erros e tarefas com falha

Erros de campo, limites de tamanho/proporção e recusas de segurança da solicitação nativa do Gemini permanecem respostas de erro compatíveis com o Gemini. O gateway não as reescreve como respostas do OpenAI Images.

Escopo suportado

Esta página cobre chamadas de geração e edição de modelo Modelflare. O enriquecimento de pesquisa ou mapa, gerenciamento de voz e gerenciamento de biblioteca de elementos são APIs de recursos fora dessa superfície pública de chamada de modelo e não são campos de solicitação obrigatórios.

Preços e cobrança

Este modelo utiliza faturamento baseado em token. Consulte a página de preços do modelo para obter o preço atual do cliente, a lista de preços de referência e as especificações completas.

Nota

Esta página documenta a interface pública do Modelflare; os campos e limites mostrados aqui são o contrato atual.