Ir para o conteúdo

Gemini 3.1 Flash Image Preview · Edit

Integrar

ID do modelo gemini-3.1-flash-image-preview/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/gemini-3.1-flash-image-preview/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitação: $ 0,08 80 créditos de API Executar nesta página

Obter chave de API
Google Edição de imagem Saída em 4KRápidoaté 4K

Edição do Gemini 3.1 Flash Image que também aceita contexto de vídeo, áudio ou PDF junto às imagens

Google · Imagem

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório 88 / 50000

Instruções de texto para editar uma imagem.

resolution padrão 1K

Resolução da imagem de saída.

padrão auto

Proporção da imagem de saída, incluindo as opções extremas 4:1, 1:4, 8:1, 1:8.

num_images padrão 1

Quantidade de imagens solicitada para geração.

Avançado system_prompt · images · video · audio · output_format · safety_tolerance · thinking_level · pdf_url · seed · limit_generations
0 / 50000

Orientação opcional de persona e estilo de saída para toda a requisição, enviada ao Gemini como instrução de sistema ou a provedores compatíveis com OpenAI como mensagem de sistema. Nada é enviado para essa instrução quando o valor está em branco.

image_urls
Solte um arquivo ou

Forneça imagens de origem por URL para edição de imagens ou geração image-to-image, a menos que você forneça pelo menos uma entrada alternativa: `video_url`, `audio_url` ou `pdf_url`.

video_url
Solte um arquivo ou

Contexto de vídeo opcional fornecido como uma URL do YouTube ou uma URL http(s)/data para um arquivo de vídeo. Links do YouTube chegam diretamente ao modelo sem download; arquivos de vídeo são baixados e enviados em linha, sujeitos ao máximo de 15 MB.

audio_url
Solte um arquivo ou

Forneça contexto de áudio opcional por meio de uma URL http(s) ou data que aponte para um arquivo de no máximo 15 MB. O arquivo é enviado em linha após o download.

output_format padrão png

Formato de arquivo da imagem resultante.

safety_tolerance padrão 4

Defina a tolerância da moderação de conteúdo entre o nível menos restritivo, 6, e o nível mais rigoroso, 1, que bloqueia a maior parte do conteúdo.

thinking_level

Selecione 'minimal' ou 'high' para ativar o pensamento do modelo nesse nível e incluir seus pensamentos na geração; deixar o nível indefinido mantém o pensamento desativado.

Forneça contexto opcional em PDF por meio de uma URL http(s) ou data que aponte para um documento de no máximo 15 MB. O documento é enviado em linha após o download.

Valor de seed que inicializa a geração de números aleatórios.

POST /run/gemini-3.1-flash-image-preview/edit?wait=20 cotação → $ 0,08
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/gemini-3.1-flash-image-preview/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Gemini 3.1 Flash Image Preview · Edit

Edita imagens com um `prompt`, usando `image_urls` e, opcionalmente, `video_url`, `audio_url` ou `pdf_url` como contexto (cada um limitado a 15MB). Suporta `resolution` de 0.5K a 4K, proporções extremas, pesquisa na web, `system_prompt` e `thinking_level`. Retorna de 1 a 4 imagens editadas.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
promptobrigatório
Tipostring
≤ 50.000 caracteres≥ 3 caracteres
Instruções de texto para editar uma imagem.
num_imagesopcional num_outputs
Tipointeger
Padrão1
1 – 4
Quantidade de imagens solicitada para geração.
seedopcional
Tipointeger | null
Valor de seed que inicializa a geração de números aleatórios.
aspect_ratioopcional
Tipoenum
Padrãoauto
auto21:916:93:24:35:41:14:53:42:39:164:11:48:11:8
Proporção da imagem de saída, incluindo as opções extremas 4:1, 1:4, 8:1, 1:8.
output_formatopcional
Tipoenum
Padrãopng
jpegpngwebp
Formato de arquivo da imagem resultante.
safety_toleranceopcional
Tipoenum
Padrão4
123456
Defina a tolerância da moderação de conteúdo entre o nível menos restritivo, 6, e o nível mais rigoroso, 1, que bloqueia a maior parte do conteúdo.
image_urlsopcional images
Tipourl[] · image
Forneça imagens de origem por URL para edição de imagens ou geração image-to-image, a menos que você forneça pelo menos uma entrada alternativa: `video_url`, `audio_url` ou `pdf_url`.
system_promptopcional
Tipostring
Padrão
≤ 50.000 caracteres
Orientação opcional de persona e estilo de saída para toda a requisição, enviada ao Gemini como instrução de sistema ou a provedores compatíveis com OpenAI como mensagem de sistema. Nada é enviado para essa instrução quando o valor está em branco.
resolutionopcional
Tipoenum
Padrão1K
0.5K1K2K4K
Resolução da imagem de saída.
video_urlopcional video
Tipourl · video
Contexto de vídeo opcional fornecido como uma URL do YouTube ou uma URL http(s)/data para um arquivo de vídeo. Links do YouTube chegam diretamente ao modelo sem download; arquivos de vídeo são baixados e enviados em linha, sujeitos ao máximo de 15 MB.
audio_urlopcional audio
Tipourl · audio
Forneça contexto de áudio opcional por meio de uma URL http(s) ou data que aponte para um arquivo de no máximo 15 MB. O arquivo é enviado em linha após o download.
pdf_urlopcional
Tipostring | null
Forneça contexto opcional em PDF por meio de uma URL http(s) ou data que aponte para um documento de no máximo 15 MB. O documento é enviado em linha após o download.
limit_generationsopcional
Tipoboolean
Padrãotrue
Limite experimental de geração que pode afetar a qualidade quando ativado. Com `True`, cada rodada de prompting é restrita a 1 geração, substituindo as instruções de quantidade de imagens no prompt e ignorando imagens intermediárias geradas pelo modelo.
thinking_levelopcional
Tipoenum
minimalhigh
Selecione 'minimal' ou 'high' para ativar o pensamento do modelo nesse nível e incluir seus pensamentos na geração; deixar o nível indefinido mantém o pensamento desativado.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "gemini-3.1-flash-image-preview/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "description": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
images
array of object {url, content_type, file_name, file_size, width, height}Imagens resultantes da edição.
description
stringDescrição que acompanha as imagens geradas.

Mais modelos: Edição de imagem

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/gemini-3.1-flash-image-preview/edit.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt