Ir para o conteúdo

gpt-image-1 · Edit Image

Integrar

ID do modelo gpt-image-1/edit-image
# 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/gpt-image-1/edit-image?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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"

Arquivos como o exemplo: $ 0,27 270 créditos de API seus arquivos são medidos antes da execução Executar nesta página

Obter chave de API

Edita ou combina imagens de referência com um prompt, configuração de fidelidade de entrada e opção de fundo transparente

OpenAI · 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

Prompt usado para gerar imagens.

•obrigatório image_urls
Solte um arquivo ou

URLs que apontam para imagens de referência para geração.

image_size padrão auto

Proporção da imagem resultante.

quality padrão auto

Qualidade da imagem resultante.

input_fidelity padrão high

Grau em que a imagem resultante segue a entrada.

num_images padrão 1

Quantidade de imagens a produzir.

Avançado background · output_format · enable_safety_checker
background padrão auto

Fundo da imagem resultante.

output_format padrão png

Formato de arquivo das imagens de saída.

POST /run/gpt-image-1/edit-image?wait=20 cotação → $ 0,27
# 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/gpt-image-1/edit-image?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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 gpt-image-1 · Edit Image

Gera novas imagens a partir de uma ou mais imagens de referência em `image_urls` e de um prompt. `input_fidelity` pode ser low ou high (high por padrão) para controlar o quanto as entradas são preservadas. Os tamanhos são auto, 1024x1024, 1536x1024 ou 1024x1536, com fundo auto, transparent ou opaque, até 4 imagens e saída png, jpeg ou webp.

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
≥ 2 caracteres
Prompt usado para gerar imagens.
image_urlsobrigatório images
Tipourl[] · image
URLs que apontam para imagens de referência para geração.
image_sizeopcional
Tipoenum
Padrãoauto
auto1024x10241536x10241024x1536
Proporção da imagem resultante.
backgroundopcional
Tipoenum
Padrãoauto
autotransparentopaque
Fundo da imagem resultante.
qualityopcional
Tipoenum
Padrãoauto
autolowmediumhigh
Qualidade da imagem resultante.
input_fidelityopcional
Tipoenum
Padrãohigh
lowhigh
Grau em que a imagem resultante segue a entrada.
num_imagesopcional num_outputs
Tipointeger
Padrão1
1 – 4
Quantidade de imagens a produzir.
output_formatopcional
Tipoenum
Padrãopng
jpegpngwebp
Formato de arquivo das imagens de saída.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador esteja autorizado.
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": "gpt-image-1/edit-image",
  "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": 270,
    "usd": "0.27",
    "charged": 270,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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
      }
    ]
  },
  "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 produzidas pelo modelo.

Mais modelos: Edição de imagem

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