콘텐츠로 건너뛰기

Topaz Upscale Image Generative

통합

모델 id topaz/upscale/image/generative
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

예시와 같은 파일: $0.08 80 API 크레딧 · ≈ ₽8.44 실행 전에 파일을 측정합니다 이 페이지에서 실행

API 키 받기
Topaz Labs 업스케일 #upscale#image

다양한 모델, 얼굴 개선 및 프롬프트 기반 Redefine 모드를 지원하는 생성형 이미지 업스케일러

Topaz Labs · 이미지

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

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

요청 만들기

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

0 / 1024

생성형 업스케일링 안내 텍스트입니다. 1024자로 제한되며 Redefine에서만 지원됩니다.

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

업스케일링할 원본 이미지 URL입니다.

기본값 Wonder 3

생성형 업스케일링 모델 선택입니다. Recovery와 Recovery V2는 매우 낮은 해상도의 이미지를 재구성하고, Redefine은 프롬프트로 창의적 디테일을 유도하며, Standard MAX는 정밀도와 높은 품질을 우선하고, Recover 3는 자연스러운 디테일을 재구성합니다. Wonder 제품군에서는 Wonder와 Wonder 2가 가장 고급 생성형 사실성 모델인 Wonder 3보다 이전 버전입니다. 최신 릴리스인 Wonder 3.5는 패턴 반복을 줄이면서 더 세밀한 디테일을 제공합니다.

기본값 2

이미지 확대 배율입니다. 예를 들어 2.0은 두 치수를 모두 2배로 확대합니다.

고급 output_format · subject_detection · enhancement_strength · face_enhancement_creativity · face_enhancement_strength · creativity · texture · sharpen · denoise · detail · crop_to_fill · face_enhancement · autoprompt · enable_safety_checker
output_format 기본값 jpeg

업스케일된 이미지에 사용할 형식입니다.

subject_detection 기본값 All

Recovery V2, Wonder 3 또는 Recovery로 이미지를 보정할 때 피사체를 감지하는 방식을 제어합니다.

enhancement_strength

생성형 업스케일링 보정 강도입니다. 지정하지 않으면 자동으로 구성되며, Wonder 3.5와 Wonder 3에서 지원됩니다.

기본값 0

얼굴 보정이 활성화된 경우에만 작동하는 얼굴 보정 창의성 제어입니다. 최대 창의성에는 1.0, 창의성 없음에는 0.0을 설정하세요.

기본값 0.8

얼굴 보정이 활성화된 경우에만 작동하는 얼굴 보정 강도 제어입니다. 최대 보정에는 1.0, 보정 없음에는 0.0을 설정하세요.

Redefine만 지원하는 1~6 범위의 생성형 업스케일링 창의성입니다. 값을 높이면 더 상상력이 풍부하거나 환각적인 디테일이 추가됩니다.

Redefine의 생성형 업스케일링 전용 텍스처 디테일 제어로, 1~5 수준을 허용합니다.

0.0~1.0 범위의 선명화 강도이며 Redefine에서만 지원됩니다.

0.0~1.0 범위의 노이즈 제거 강도이며 Redefine에서만 지원됩니다.

0.0~1.0 범위의 디테일 복원 강도이며 Recovery V2에서만 지원됩니다.

POST /run/topaz/upscale/image/generative?wait=20 견적 → $0.08
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

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

Topaz Upscale Image Generative 정보

Wonder 3.5, Wonder 3, Recover 3, Redefine 및 Recovery V2를 포함한 `model`을 선택해 이미지를 1x~4x로 업스케일합니다. 얼굴 개선에는 별도의 강도 및 창의성 슬라이더가 있습니다. Redefine은 최대 1024자의 `prompt`와 `creativity`, `texture`, `sharpen` 및 `denoise`를 추가합니다. 작거나 흐릿한 원본에 적합합니다.

매개변수

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

이름유형 기본값허용됨 설명
image_url필수 image
유형url · image
업스케일링할 원본 이미지 URL입니다.
model선택 사항
유형enum
기본값Wonder 3
Wonder 3.5Wonder 3Wonder 2WonderRecover 3Standard MAXRedefineRecovery V2Recovery
생성형 업스케일링 모델 선택입니다. Recovery와 Recovery V2는 매우 낮은 해상도의 이미지를 재구성하고, Redefine은 프롬프트로 창의적 디테일을 유도하며, Standard MAX는 정밀도와 높은 품질을 우선하고, Recover 3는 자연스러운 디테일을 재구성합니다. Wonder 제품군에서는 Wonder와 Wonder 2가 가장 고급 생성형 사실성 모델인 Wonder 3보다 이전 버전입니다. 최신 릴리스인 Wonder 3.5는 패턴 반복을 줄이면서 더 세밀한 디테일을 제공합니다.
upscale_factor선택 사항
유형number
기본값2
1 – 4
이미지 확대 배율입니다. 예를 들어 2.0은 두 치수를 모두 2배로 확대합니다.
crop_to_fill선택 사항
유형boolean
기본값false
output_format선택 사항
유형enum
기본값jpeg
jpegpng
업스케일된 이미지에 사용할 형식입니다.
subject_detection선택 사항
유형enum
기본값All
AllForegroundBackground
Recovery V2, Wonder 3 또는 Recovery로 이미지를 보정할 때 피사체를 감지하는 방식을 제어합니다.
face_enhancement선택 사항
유형boolean
기본값true
이미지의 얼굴 보정 토글입니다.
face_enhancement_creativity선택 사항
유형number
기본값0
0 – 1
얼굴 보정이 활성화된 경우에만 작동하는 얼굴 보정 창의성 제어입니다. 최대 창의성에는 1.0, 창의성 없음에는 0.0을 설정하세요.
face_enhancement_strength선택 사항
유형number
기본값0.8
0 – 1
얼굴 보정이 활성화된 경우에만 작동하는 얼굴 보정 강도 제어입니다. 최대 보정에는 1.0, 보정 없음에는 0.0을 설정하세요.
enhancement_strength선택 사항
유형enum
lowmediumhigh
생성형 업스케일링 보정 강도입니다. 지정하지 않으면 자동으로 구성되며, Wonder 3.5와 Wonder 3에서 지원됩니다.
creativity선택 사항
유형integer | null
1 – 6
Redefine만 지원하는 1~6 범위의 생성형 업스케일링 창의성입니다. 값을 높이면 더 상상력이 풍부하거나 환각적인 디테일이 추가됩니다.
texture선택 사항
유형integer | null
1 – 5
Redefine의 생성형 업스케일링 전용 텍스처 디테일 제어로, 1~5 수준을 허용합니다.
prompt선택 사항
유형string | null
≤ 1,024자
생성형 업스케일링 안내 텍스트입니다. 1024자로 제한되며 Redefine에서만 지원됩니다.
autoprompt선택 사항
유형boolean | null
Redefine의 생성형 업스케일링에서만 사용할 수 있는 자동 프롬프트 생성 토글입니다.
sharpen선택 사항
유형number | null
0 – 1
0.0~1.0 범위의 선명화 강도이며 Redefine에서만 지원됩니다.
denoise선택 사항
유형number | null
0 – 1
0.0~1.0 범위의 노이즈 제거 강도이며 Redefine에서만 지원됩니다.
detail선택 사항
유형number | null
0 – 1
0.0~1.0 범위의 디테일 복원 강도이며 Recovery V2에서만 지원됩니다.
enable_safety_checker선택 사항
유형boolean
기본값true
호출자에게 권한이 있으면 false로 설정해 검사를 완화할 수 있습니다.
필수 표준 이름, 사용 가능

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

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "topaz/upscale/image/generative",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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
    }
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
image
object {url, content_type, file_name, file_size}업스케일링으로 생성된 이미지입니다.

더 많은 모델: 업스케일

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