gemini-2.5-flash-image API

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

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

Parâmetros: size=2Kratio=16:9

Prompt: The paint aisle of a hardware store, fluorescent tubes and rows of colour chip cards. A woman in a chrome puffer coat has just run one hand along the rack. Every card she touched has lifted off its peg and the whole aisle is filling with them, thousands of paper chips turning in the air and sorting themselves into a single smooth gradient wall from deep violet to hot orange. Cold fluorescent ambient, one hard warm slash of light from the end of the aisle. Wide low camera down the aisle, paper edges catching the light, film grain, no text.

Solicitação que produziu esta amostra

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "The paint aisle of a hardware store, fluorescent tubes and rows of colour chip cards. A woman in a chrome puffer coat has just run one hand along the rack. Every card she touched has lifted off its peg and the whole aisle is filling with them, thousands of paper chips turning in the air and sorting themselves into a single smooth gradient wall from deep violet to hot orange. Cold fluorescent ambient, one hard warm slash of light from the end of the aisle. Wide low camera down the aisle, paper edges catching the light, film grain, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

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-2.5-flash-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 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	Não	1K / 2K / 4K

Limites de resposta e entrada

Gemini 2.5 Flash Image suporta 1K, 2K e 4K com 1:1, 4:3, 3:4, 16:9 e 9:16. 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.

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-2.5-flash-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-2.5-flash-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 cobrança por chamada. 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.