콘텐츠로 건너뛰기

Image2Pixel

통합

모델 id 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"

실행당 최대 $0.153 실제 사용량에 따라 과금되며 나머지는 환불됩니다 이 페이지에서 실행

API 키 받기
Utility 이미지 편집 #post-processing#pixel-art

팔레트 제한, 배율 감지 및 선택적 투명 배경을 지원해 이미지를 깔끔한 픽셀 아트로 변환합니다

Utility · 이미지

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수 image_url
파일을 끌어다 놓거나

개선된 픽셀 아트로 변환할 원본 이미지 URL입니다.

고급 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 기본값 auto

스케일을 감지하는 데 사용하는 방법입니다.

downscale_method 기본값 dominant

픽셀 아트로 축소하는 데 사용하는 방법입니다.

background_mode 기본값 corners

배경 제거 중 flood-fill을 시작할 위치입니다.

기본값 32

출력 팔레트 색상 상한입니다. None이면 색상 수에 제한이 없습니다.

적용할 픽셀 스케일입니다. None이면 자동으로 감지합니다.

기본값 128

알파 이진화 임계값으로, 0에서 255까지입니다.

기본값 0.05

주요 색상 임계값으로, 0.0에서 1.0까지입니다.

기본값 0

배경 허용 오차로, 0에서 255까지입니다.

['#000000', '#ffffff']와 같은 hex 문자열로 지정하는 선택적 사전 정의 팔레트입니다.

POST /run/image2pixel?wait=20 견적 → $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"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Image2Pixel 정보

입력 이미지를 픽셀 아트로 변환하고 처리된 이미지와 크기가 조정된 버전을 PNG 파일로 반환합니다. `max_colors`(1~256)로 팔레트의 최대 색상 수를 제한하거나, 16진수 색상으로 구성된 `fixed_palette`를 제공하거나, `scale`을 1~64로 강제할 수 있습니다. 여러 축소 방식, 정리 옵션 및 배경 제거 모드를 사용할 수 있습니다. 응답에는 색상 수, 팔레트 및 감지된 픽셀 배율도 포함됩니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
image_url필수 image
유형url · image
개선된 픽셀 아트로 변환할 원본 이미지 URL입니다.
max_colors선택 사항
유형integer | null
기본값32
1 – 256
출력 팔레트 색상 상한입니다. None이면 색상 수에 제한이 없습니다.
auto_color_detect선택 사항
유형boolean
기본값false
최적 색상 수를 자동으로 선택합니다.
fixed_palette선택 사항
유형string[]
['#000000', '#ffffff']와 같은 hex 문자열로 지정하는 선택적 사전 정의 팔레트입니다.
detect_method선택 사항
유형enum
기본값auto
autorunsedge
스케일을 감지하는 데 사용하는 방법입니다.
scale선택 사항
유형integer | null
1 – 64
적용할 픽셀 스케일입니다. None이면 자동으로 감지합니다.
downscale_method선택 사항
유형enum
기본값dominant
dominantmedianmodemeancontent-adaptive
픽셀 아트로 축소하는 데 사용하는 방법입니다.
trim_borders선택 사항
유형boolean
기본값false
이미지 테두리 자르기를 제어합니다.
transparent_background선택 사항
유형boolean
기본값false
투명도를 통한 배경 제거입니다. 이미지 보정이 완료되면 이미지 가장자리에 닿는 연결된 색상 영역이 투명해집니다.
cleanup_morph선택 사항
유형boolean
기본값false
형태학적 연산을 사용해 노이즈를 제거합니다.
cleanup_jaggy선택 사항
유형boolean
기본값false
고립된 대각선 픽셀을 제거해 톱니 모양 가장자리를 정리합니다.
snap_grid선택 사항
유형boolean
기본값true
출력을 픽셀 그리드에 맞춥니다.
alpha_threshold선택 사항
유형integer
기본값128
0 – 255
알파 이진화 임계값으로, 0에서 255까지입니다.
dominant_color_threshold선택 사항
유형number
기본값0.05
0 – 1
주요 색상 임계값으로, 0.0에서 1.0까지입니다.
background_tolerance선택 사항
유형integer
기본값0
0 – 255
배경 허용 오차로, 0에서 255까지입니다.
background_mode선택 사항
유형enum
기본값corners
edgescornersmidpoints
배경 제거 중 flood-fill을 시작할 위치입니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

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"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
pixel_scale
integer입력에서 감지된 픽셀 스케일입니다.
palette
array of string처리된 미디어의 색상 팔레트입니다.
num_colors
integer처리된 미디어의 색상 수입니다.
images
array of object {url, content_type, file_name, file_size, width, height}처리된 픽셀 아트와 스케일 조정 이미지이며, 모두 PNG 형식입니다.

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/image2pixel.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt