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

네. OpenClaw에서 RunAPI를 provider로 설정했다면, 동일한 API key와 endpoint가 Z Image 요청을 처리합니다. model을 z-image로 설정하여 text_to_image endpoint에 POST 요청을 보내세요.

Z Image에 별도의 API key가 필요한가요?

아니요. 채팅과 다른 모델에 사용하는 동일한 RUNAPI_API_KEY가 Z Image에도 사용됩니다. 모든 RunAPI 모델은 하나의 key와 하나의 크레딧 잔액을 공유합니다.

Z Image는 비동기인가요, 동기인가요?

Z Image는 비동기입니다. API는 즉시 task_id를 반환합니다. 이미지가 준비되면 task status endpoint를 폴링하거나 webhook callback을 사용하세요. RunAPI SDK는 폴링을 자동으로 처리합니다.

Z Image 비용은 얼마인가요?

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

OPENCLAW + Z IMAGE

OpenClaw에서 Z Image 사용하기.

Z Image는 중국어와 영어 이중 언어 텍스트 렌더링을 갖춘 Alibaba의 빠른 이미지 생성 모델입니다. OpenClaw agent는 채팅에 사용하는 동일한 RunAPI endpoint와 API key로 호출합니다 — 추가 skill이나 provider 계정이 필요 없습니다.

API Key 받기 문서 읽기

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

Use the RunAPI text_to_image endpoint to generate an image with Z Image.

Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Send a POST request to https://runapi.ai/v1/text_to_image.
- Set model to "z-image".
- Write a descriptive prompt for the image you want to generate.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the image URL from the output.

curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
  }'

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

curl 명령어를 복사하여 테스트하세요 z-image

작동 방식

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

RunAPI 설정

RunAPI API key를 환경 변수로 설정하세요. 이미 OpenClaw에서 채팅용 RunAPI를 설정했다면, 동일한 key가 이미지 생성에도 사용됩니다.

export RUNAPI_API_KEY=runapi_xxx

Z Image 호출

model을 z-image로 설정하고 텍스트 프롬프트를 포함하여 text_to_image endpoint에 POST 요청을 보내세요. Z Image는 정확한 텍스트 렌더링으로 중국어와 영어 프롬프트를 모두 지원합니다.

text_to_image

결과 가져오기

API는 즉시 task_id를 반환합니다. status가 completed로 변경될 때까지 task status endpoint를 폴링한 뒤, 응답 출력에서 생성된 이미지 URL을 가져오세요.

task_id: tsk_abc123

파라미터

Z Image API 파라미터

파라미터	유형	설명
`model`	`string`	필수. z-image를 사용하세요.
`prompt`	`string`	텍스트 설명. 중국어와 영어를 지원합니다.
`negative_prompt`	`string`	선택 사항. 이미지에서 피해야 할 것.
`size`	`string`	선택 사항. 출력 크기, 예) 1024x1024.

OpenClaw의 Z Image란?

Z Image는 속도 최적화 이미지 모델로 Apache 2.0 오픈소스, 중국어·영어 양방향 텍스트 렌더링 지원, RunAPI 기준 장당 약 $0.004로 최저가 옵션 중 하나입니다. OpenClaw agent는 채팅과 동일한 API 키로 호출합니다.

Z Image 활용 사례

컨셉 탐색 및 빠른 프로토타이핑

1센트당 수십 장의 속도로 시각적 컨셉을 생성해 최종 출력에 더 비싼 모델을 사용하기 전에 여러 방향을 탐색하기에 이상적입니다.

이중 언어 마케팅 캠페인

이미지 한 장에 중국어와 영어 텍스트를 정확하게 렌더링해 크로스보더 이커머스와 다국어 소셜 미디어용 마케팅 비주얼을 제작합니다.

패션 및 제품 사진 목업

정확한 재질 텍스처와 조명으로 사실적인 제품 사진 목업을 생성하며, 실시간 크리에이티브 논의에서 구도를 반복할 수 있을 만큼 빠릅니다.

FAQ

Z Image + OpenClaw 자주 묻는 질문

OpenClaw 일반 설정

아직 설정하지 않으셨나요? OpenClaw용 RunAPI 설정 가이드로 시작하세요.

OpenClaw 설정 가이드 →

Z Image 모델 카탈로그

Z Image의 모든 변형, 가격, API 문서를 확인하세요.

Z Image 모델 →

지금 OpenClaw에서 Z Image를 사용해보세요.

무료 RunAPI key를 발급받고, OpenClaw에 프롬프트를 붙여넣어 이중 언어 텍스트 렌더링으로 이미지를 생성해보세요.

모델 보기 →