OpenClaw에서 GPT Image를 사용하세요.
GPT Image 2는 OpenAI의 전용 이미지 생성 모델로 — 최대 4K 출력 해상도와 투명 배경 지원으로 텍스트-이미지 생성 및 지시 기반 이미지 편집을 제공합니다. OpenClaw 에이전트는 추가 스킬 설치 없이 채팅에 사용하는 동일한 RunAPI key와 /v1 엔드포인트로 호출합니다.
Use RunAPI to generate an image with OpenAI GPT Image 2.
Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Set the model to "gpt-image-2-text-to-image".
- Write a descriptive prompt. GPT Image 2 follows natural language instructions closely — describe layout, style, text overlays, and transparency needs.
- Optionally set output_resolution to 1k, 2k, or 4k. Default is 1k.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2-text-to-image",
"prompt": "A product photo of a glass perfume bottle on a marble surface, transparent background, studio lighting, the label reads AURORA in gold serif font",
"output_resolution": "2k",
"aspect_ratio": "3:4"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "gpt-image-2-text-to-image"
}
3단계로 OpenClaw에서 GPT Image 사용하기
RunAPI 설정
셸 프로필에 RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 채팅을 위해 OpenClaw에 RunAPI가 설정되어 있다면, 동일한 key로 GPT Image를 사용할 수 있습니다 — 추가 설정이 필요 없습니다.
export RUNAPI_API_KEY=runapi_xxx
GPT Image 2 호출
model을 gpt-image-2-text-to-image로 설정하여 text_to_image 엔드포인트에 POST 요청을 보내세요. 레이아웃과 스타일 지시가 포함된 설명적인 프롬프트를 포함하세요. 더 높은 디테일을 위해 output_resolution을 2k 또는 4k로 설정하세요. 기존 이미지 편집의 경우 gpt-image-2-image-to-image로 edit_image 엔드포인트를 사용하고 source_image_urls를 제공하세요.
POST /v1/text_to_image
결과 받기
API는 즉시 task_id를 반환합니다. status가 completed로 변경될 때까지 task status 엔드포인트를 폴링한 후 응답에서 출력 이미지 URL을 가져오세요. GPT Image 2는 해상도에 따라 일반적으로 10~30초 내에 완료됩니다.
task_id: tsk_abc123
GPT Image API 파라미터
| 파라미터 | 유형 | 설명 |
|---|---|---|
model |
string |
필수. 생성에는 gpt-image-2-text-to-image, 편집에는 gpt-image-2-image-to-image. |
prompt |
string |
필수. 원하는 이미지에 대한 자연어 설명. 레이아웃, 텍스트 오버레이, 스타일에 대한 상세한 지시를 지원합니다. |
output_resolution |
string |
선택 사항. 출력 해상도 — 1k (기본값), 2k, 또는 4k. 해상도가 높을수록 이미지당 비용이 더 높습니다. |
aspect_ratio |
string |
선택 사항. 기본값은 auto. 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16 등을 지원합니다. |
source_image_urls |
array |
edit_image 엔드포인트에 필수. 편집할 소스 이미지의 URL 하나 이상. |
OpenClaw의 GPT Image란?
GPT Image 2는 OpenAI의 전용 이미지 모델로 키워드 기반 생성기보다 구조화된 디자인 어시스턴트처럼 작동합니다. 제작 브리프——레이아웃·텍스트 배치·스타일 제약——를 주면 지시를 엄격히 따릅니다. OpenClaw agent는 채팅과 동일한 RunAPI 엔드포인트를 통해 호출합니다.
GPT Image 활용 사례
브랜드 비주얼 및 광고 디자인
상세한 제작 브리프를 기반으로 브랜드 광고·소셜 미디어 배너·마케팅 비주얼을 생성하며——정확한 레이아웃·텍스트 배치·스타일 제약을 지정하면 GPT Image 2가 엄격히 실행합니다.
투명 배경이 있는 제품 이미지
후처리 없이 이커머스 사이트·마케팅 자료·UI 오버레이에 직접 사용할 수 있는 투명 배경이 있는 제품 쇼케이스 이미지를 생성합니다.
UI 목업 및 인터페이스 컨셉 이미지
읽기 쉬운 텍스트 레이블과 명확한 레이아웃 계층구조가 있는 UI 목업과 앱 인터페이스 컨셉 이미지를 생성해 개발 팀 검토 전에 빠르게 디자인 컨셉을 시각화합니다.
GPT Image + OpenClaw 질문
네. OpenClaw 에이전트는 RunAPI text_to_image 엔드포인트를 통해 GPT Image 2를 호출합니다. model 필드를 gpt-image-2-text-to-image로 설정하고 채팅에 사용하는 동일한 RUNAPI_API_KEY로 요청을 보내세요. 추가 스킬이나 플러그인이 필요 없습니다.
GPT Image 2는 더 높은 품질, 4K 출력, 투명 배경 지원을 갖춘 OpenAI의 전용 이미지 생성 모델입니다. GPT-4o Image는 채팅 컨텍스트 내에서 이미지를 생성하지만 1:1, 3:2, 2:3 종횡비로 제한됩니다. 두 모델 모두 RunAPI를 통해 사용 가능합니다 — 독립적인 생성에는 gpt-image-2-text-to-image를, 채팅 통합 이미지 출력에는 gpt-4o-image를 사용하세요.
네. GPT Image 2는 프롬프트에서 지시할 때 투명 배경이 있는 이미지를 출력할 수 있습니다. 이는 제품 사진, 로고, UI 요소에 유용합니다. 프롬프트에 투명도를 명시하세요 — 예: "transparent background가 있는 제품 사진."
GPT Image 2는 출력 해상도에 따라 이미지당 청구됩니다: 1k가 가장 저렴하고, 2k는 중간 요금이며, 4k가 가장 비쌉니다. text_to_image와 edit_image 모두 동일한 요금이 적용됩니다. 현재 이미지당 요금은 RunAPI 가격 페이지를 확인하세요. 실패한 생성은 청구되지 않습니다.
네. model을 gpt-image-2-image-to-image로 설정하여 edit_image 엔드포인트를 사용하세요. source_image_urls에 소스 이미지 URL을 전달하고 프롬프트에 편집 내용을 설명하세요 — 예: "배경을 해변 석양으로 변경" 또는 "사람에게 빨간 모자 추가." GPT Image 2는 자연어 편집 지시를 따릅니다.
지금 OpenClaw에서 GPT Image를 사용해보세요.
무료 RunAPI key를 발급받고, OpenClaw에 프롬프트를 붙여넣어 OpenAI GPT Image 2로 이미지 생성 및 편집을 시작하세요.