OpenClaw에서 Topaz를 사용할 수 있나요?

네. OpenClaw에서 RunAPI를 OpenAI 호환 provider로 설정한 뒤, Topaz upscale_image endpoint를 호출하도록 agent에 지시하세요. 채팅과 이미지 생성에 사용하는 동일한 RUNAPI_API_KEY가 업스케일링 요청도 처리합니다.

Topaz에 별도의 API key가 필요한가요?

아니요. 채팅, 이미지 생성 및 다른 모델에 사용하는 동일한 RUNAPI_API_KEY가 Topaz 업스케일링에도 사용됩니다. 모든 RunAPI 모델은 하나의 API key와 하나의 크레딧 잔액을 공유합니다.

Topaz 업스케일링은 비동기인가요, 동기인가요?

Topaz 업스케일링은 비동기입니다. endpoint는 즉시 task_id를 반환합니다. OpenClaw agent는 업스케일된 이미지가 준비될 때까지 task status endpoint를 폴링합니다. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

Topaz 업스케일링 비용은 얼마인가요?

Topaz는 RunAPI를 통해 task당 사용한 만큼 청구됩니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요. 월 구독이나 최소 지출이 없습니다.

OPENCLAW + TOPAZ

OpenClaw에서 Topaz 사용하기.

Topaz Labs의 Topaz는 아티팩트 없이 세부 사항을 복원하는 신경망을 사용하여 이미지를 최대 8배 해상도로 업스케일합니다. OpenClaw agent는 채팅과 이미지 생성에 사용하는 동일한 RunAPI key로 호출합니다 — 이미지 URL을 보내고, 배율 인수를 선택하고, 향상된 결과를 폴링하세요.

API Key 받기 문서 읽기

하나의 API key · 이미지 업스케일 엔드포인트 · 비동기 작업 폴링

Use RunAPI to upscale an image with Topaz.

Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Call the RunAPI upscale_image endpoint at https://runapi.ai/api/v1/topaz/upscale_image.
- Set model to "topaz-upscale-image".
- Pass the image URL in image_url.
- Optionally set scale to 2, 4, or 8 (default is 2).
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the upscaled image URL from the result.

curl -X POST https://runapi.ai/api/v1/topaz/upscale_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "topaz-upscale-image",
    "image_url": "https://example.com/photo.jpg",
    "scale": 4
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "topaz-upscale-image"
}

curl 명령어를 복사하여 테스트하세요 topaz

작동 방식

OpenClaw에서 Topaz를 세 단계로 사용하기

RunAPI 설정

아직 OpenClaw에서 RunAPI를 설정하지 않았다면 OpenClaw 설정 가이드를 따르세요. RUNAPI_API_KEY 환경 변수를 설정하고, baseUrl을 https://runapi.ai/v1로 설정하여 RunAPI를 OpenAI 호환 provider로 추가하세요.

export RUNAPI_API_KEY=runapi_xxx

Topaz upscale_image 호출

model을 topaz-upscale-image로, 소스 image_url과 선택적으로 2, 4, 또는 8의 scale 인수를 설정하여 upscale_image endpoint에 POST 요청을 보내세요. 동일한 RunAPI key가 인증을 처리합니다.

POST /api/v1/topaz/upscale_image

결과 폴링

endpoint는 status pending으로 task_id를 반환합니다. status가 completed로 변경될 때까지 task status endpoint를 폴링한 뒤, 응답에서 업스케일된 이미지 URL을 가져오세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

GET /api/v1/topaz/upscale_image/tsk_abc123

파라미터

Topaz upscale_image API 파라미터

파라미터	유형	설명
`model`	`string`	필수. topaz-upscale-image 또는 topaz-upscale-video.
`image_url`	`string`	업스케일할 이미지의 URL.
`scale`	`integer`	선택 사항. 업스케일 배율: 2, 4, 또는 8. 기본값 2.
`callback_url`	`string`	선택 사항. 비동기 완료 알림을 위한 webhook URL.

OpenClaw의 Topaz란?

Topaz는 사진가들이 '사진 충실도의 금 기준'이라 부르는 프로급 이미지 마무리 도구입니다. 이미지를 최대 8배 해상도로 업스케일하며 원본에 충실한 선명한 결과를 출력합니다. RunAPI에서는 데스크탑 앱 구독이 아닌 API 엔드포인트로 동작해, OpenClaw agent가 자동화된 이미지 파이프라인의 한 단계로 업스케일을 포함시킬 수 있습니다.