Avançar para o conteúdo

Image2Pixel

Integrar

ID do modelo image2pixel
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/image2pixel?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

Até 0,153 $ por execução cobrado com base na utilização real, o restante é reembolsado Executar nesta página

Obter chave de API
Utility Edição de imagem #post-processing#pixel-art

Converte imagens em pixel art limpa, com limites de paleta, deteção de escala e fundo transparente opcional

Utility · 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 image_url
Largue um ficheiro ou

URL da imagem de origem para conversão em pixel art melhorada.

Avançado detect_method · downscale_method · background_mode · max_colors · scale · alpha_threshold · dominant_color_threshold · background_tolerance · auto_color_detect · trim_borders · transparent_background · cleanup_morph · cleanup_jaggy · snap_grid · fixed_palette
detect_method predefinição auto

Método utilizado para detetar a escala.

downscale_method predefinição dominant

Método utilizado para reduzir a escala e criar pixel art.

background_mode predefinição corners

Localizações iniciais para o preenchimento durante a remoção do fundo.

predefinição 32

Limite de cores da paleta de saída; None permite um número ilimitado de cores.

Escala de píxeis a impor; None ativa a deteção automática.

predefinição 128

Limiar para binarizar alfa, de 0 a 255.

predefinição 0.05

Limiar para cores dominantes, de 0.0 a 1.0.

predefinição 0

Tolerância para o fundo, de 0 a 255.

Paleta predefinida opcional especificada com cadeias hexadecimais, como ['#000000', '#ffffff'].

POST /run/image2pixel?wait=20 cotação → 0,153 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/image2pixel?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 Image2Pixel

Transforma uma imagem de entrada em pixel art e devolve a imagem processada, além de uma versão redimensionada, como ficheiros PNG. Pode limitar a paleta com `max_colors` (1 a 256), fornecer uma `fixed_palette` de cores hexadecimais ou forçar uma `scale` de 1 a 64. Estão disponíveis vários métodos de redução, opções de limpeza e modos de remoção do fundo. A resposta também indica o número de cores, a paleta e a escala de píxeis detetada.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
image_urlobrigatório image
Tipourl · image
URL da imagem de origem para conversão em pixel art melhorada.
max_colorsopcional
Tipointeger | null
Predefinição32
1 – 256
Limite de cores da paleta de saída; None permite um número ilimitado de cores.
auto_color_detectopcional
Tipoboolean
Predefiniçãofalse
Ativa a seleção automática do número ideal de cores.
fixed_paletteopcional
Tipostring[]
Paleta predefinida opcional especificada com cadeias hexadecimais, como ['#000000', '#ffffff'].
detect_methodopcional
Tipoenum
Predefiniçãoauto
autorunsedge
Método utilizado para detetar a escala.
scaleopcional
Tipointeger | null
1 – 64
Escala de píxeis a impor; None ativa a deteção automática.
downscale_methodopcional
Tipoenum
Predefiniçãodominant
dominantmedianmodemeancontent-adaptive
Método utilizado para reduzir a escala e criar pixel art.
trim_bordersopcional
Tipoboolean
Predefiniçãofalse
Controla o recorte das margens da imagem.
transparent_backgroundopcional
Tipoboolean
Predefiniçãofalse
Remoção do fundo através de transparência: quando a correção da imagem termina, as regiões de cor ligadas que tocam numa margem da imagem tornam-se transparentes.
cleanup_morphopcional
Tipoboolean
Predefiniçãofalse
Remoção de ruído através de operações morfológicas.
cleanup_jaggyopcional
Tipoboolean
Predefiniçãofalse
Limpeza de contornos serrilhados através da remoção de píxeis diagonais isolados.
snap_gridopcional
Tipoboolean
Predefiniçãotrue
Alinha a saída com a grelha de píxeis.
alpha_thresholdopcional
Tipointeger
Predefinição128
0 – 255
Limiar para binarizar alfa, de 0 a 255.
dominant_color_thresholdopcional
Tiponumber
Predefinição0.05
0 – 1
Limiar para cores dominantes, de 0.0 a 1.0.
background_toleranceopcional
Tipointeger
Predefinição0
0 – 255
Tolerância para o fundo, de 0 a 255.
background_modeopcional
Tipoenum
Predefiniçãocorners
edgescornersmidpoints
Localizações iniciais para o preenchimento durante a remoção do fundo.
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": "image2pixel",
  "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": 153,
    "usd": "0.153",
    "charged": 153,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "pixel_scale": 21,
    "palette": [
      "string"
    ],
    "num_colors": 10,
    "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://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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
pixel_scale
integerEscala de píxeis detetada na entrada.
palette
array of stringPaleta de cores do conteúdo multimédia processado.
num_colors
integerNúmero de cores do conteúdo multimédia processado.
images
array of object {url, content_type, file_name, file_size, width, height}Pixel art processada e imagens redimensionadas, ambas no formato PNG.

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/image2pixel.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt