Avançar 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"

Ficheiros como o exemplo: 0,27 $ 270 créditos da API os seus ficheiros 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, definição de fidelidade de entrada e opção de fundo transparente

OpenAI · Imagem

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório

Prompt utilizado para gerar imagens.

•obrigatório image_urls
Largue um ficheiro ou

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

image_size predefinição auto

Proporção da imagem resultante.

quality predefinição auto

Qualidade da imagem resultante.

input_fidelity predefinição high

Grau em que a imagem resultante segue a entrada.

num_images predefinição 1

Contagem de imagens a produzir.

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

Fundo da imagem resultante.

output_format predefinição png

Formato de ficheiro 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 este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar 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 predefinição) para controlar a proximidade com que as entradas são preservadas. Os tamanhos são auto, 1024x1024, 1536x1024 ou 1024x1536, com fundo auto, transparente ou opaco, 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 PredefiniçãoPermitido Descrição
promptobrigatório
Tipostring
≥ 2 caracteres
Prompt utilizado para gerar imagens.
image_urlsobrigatório images
Tipourl[] · image
URLs que apontam para imagens de referência para geração.
image_sizeopcional
Tipoenum
Predefiniçãoauto
auto1024x10241536x10241024x1536
Proporção da imagem resultante.
backgroundopcional
Tipoenum
Predefiniçãoauto
autotransparentopaque
Fundo da imagem resultante.
qualityopcional
Tipoenum
Predefiniçãoauto
autolowmediumhigh
Qualidade da imagem resultante.
input_fidelityopcional
Tipoenum
Predefiniçãohigh
lowhigh
Grau em que a imagem resultante segue a entrada.
num_imagesopcional num_outputs
Tipointeger
Predefinição1
1 – 4
Contagem de imagens a produzir.
output_formatopcional
Tipoenum
Predefiniçãopng
jpegpngwebp
Formato de ficheiro das imagens de saída.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
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á disponível em https://doitong.com/pt-PT/developers/models/gpt-image-1/edit-image.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt