OpenClaw에서 Qwen 2 Image 사용하기.
Qwen 2 Image는 Alibaba의 이미지 생성 및 편집 모델입니다. OpenClaw agent는 채팅에 사용하는 동일한 RunAPI endpoint를 통해 호출합니다 — 프롬프트를 보내면 이미지 URL을 받습니다. 세 가지 모델 변형으로 텍스트-이미지, 이미지 편집, 이미지 리믹싱을 지원합니다.
Use RunAPI to generate an image with Qwen 2 Image.
Requirements:
- Call the RunAPI text_to_image endpoint at https://runapi.ai/api/v1/task/text_to_image.
- Set the model to "qwen-2-text-to-image".
- Read the API key from the RUNAPI_API_KEY environment variable.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the image URL from the output.
- For image editing, use model "qwen-2-edit-image" and include an image_url field.
- For remixing, use model "qwen-2-remix-image" and include an image_url field.
curl -X POST https://runapi.ai/api/v1/task/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-2-text-to-image",
"prompt": "A traditional Chinese ink painting of misty mountains at dawn, elegant brushwork"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "qwen-2-text-to-image"
}
OpenClaw에서 Qwen 2 Image를 세 단계로 사용하기
RunAPI 설정
RunAPI API key를 환경 변수로 설정하세요. 아직 OpenClaw provider로 RunAPI를 추가하지 않았다면 OpenClaw 설정 가이드를 먼저 따르세요.
export RUNAPI_API_KEY=runapi_xxx
Qwen 2 Image 호출
프롬프트를 OpenClaw에 붙여넣거나 text_to_image endpoint를 직접 호출하세요. 생성은 qwen-2-text-to-image, 편집은 qwen-2-edit-image, 리믹스는 qwen-2-remix-image로 model 필드를 설정하세요.
text_to_image
결과 가져오기
endpoint는 task ID를 반환합니다. status가 completed로 변경될 때까지 task status endpoint를 폴링한 뒤, 출력에서 이미지 URL을 읽으세요. RunAPI SDK는 폴링을 자동으로 처리합니다.
task_id: tsk_abc123
Qwen 2 Image API 파라미터
| 파라미터 | 유형 | 설명 |
|---|---|---|
model |
string |
필수. qwen-2-text-to-image, qwen-2-edit-image, 또는 qwen-2-remix-image. |
prompt |
string |
텍스트 설명 또는 편집 지시문. |
image_url |
string |
편집 또는 리믹스 모드를 위한 소스 이미지. |
size |
string |
선택 사항. 출력 크기. |
OpenClaw의 Qwen 2 Image란?
Qwen 2 Image는 Alibaba의 이미지 모델로 단일 API에서 생성·편집·리믹스 세 가지 모드를 지원합니다. 다국어 프롬프트 이해(특히 중국어·영어)에 뛰어나고, 복잡한 멀티 객체 장면을 처리하며, 자연어로 변경 내용을 설명하는 지시 기반 편집을 지원합니다.
Qwen 2 Image 활용 사례
다국어 마케팅 캠페인
중국어·영어·혼합 언어 텍스트로 작성된 프롬프트에서 이미지를 생성해 사전 번역 없이 이중 언어 마케팅 자료를 제작합니다.
지시 기반 이미지 편집
기존 이미지를 일상 언어로 변경 내용을 설명해 수정합니다——배경 교체·객체 추가·조명 조정·요소 제거를 에디터 없이 처리합니다.
특정 도메인용 오픈 웨이트 모델 파인튜닝
Qwen 2 Image 출력물을 제품 카탈로그나 브랜드 콘텐츠 같은 도메인 특화 이미지 작업을 위한 오픈 웨이트 Qwen 모델 파인튜닝의 학습 데이터나 베이스라인으로 활용합니다.
Qwen 2 Image + OpenClaw 자주 묻는 질문
네. OpenClaw는 custom OpenAI 호환 provider를 지원합니다. baseUrl을 https://runapi.ai/v1로, RUNAPI_API_KEY를 사용하여 RunAPI를 추가한 뒤, model을 qwen-2-text-to-image로 설정하여 text_to_image endpoint를 호출하세요. 동일한 provider가 채팅과 이미지 생성을 모두 처리합니다.
아니요. 채팅 모델에 사용하는 동일한 RUNAPI_API_KEY로 Qwen 2 Image와 RunAPI 카탈로그의 다른 모든 모델을 호출할 수 있습니다. 하나의 key, 하나의 잔액, 하나의 대시보드입니다.
비동기입니다. endpoint는 즉시 task ID를 반환합니다. 이미지가 준비되면 task status endpoint를 폴링하거나 webhook callback을 사용하세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.
Qwen 2 Image는 task당 청구됩니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요. 월 구독이나 최소 지출이 없으며 완료된 생성에 대해서만 비용을 지불합니다.