--- title: "RunAPI를 통해 OpenClaw에서 GPT Image 사용하기 — Image API 가이드" url: "https://runapi.ai/ko/openclaw-gpt-image.md" canonical: "https://runapi.ai/ko/openclaw-gpt-image" locale: "ko" model: "gpt-image" --- # OpenClaw에서 GPT Image를 사용하세요. GPT Image 2는 OpenAI의 전용 이미지 생성 모델로 — 최대 4K 출력 해상도와 투명 배경 지원으로 텍스트-이미지 생성 및 지시 기반 이미지 편집을 제공합니다. OpenClaw 에이전트는 추가 스킬 설치 없이 채팅에 사용하는 동일한 RunAPI key와 /v1 엔드포인트로 호출합니다. ## API example ```bash 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" }' ``` ### Response ```json { "task_id": "tsk_abc123", "status": "pending", "model": "gpt-image-2-text-to-image" } ``` ## How it works 1. **RunAPI 설정** — 셸 프로필에 RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 채팅을 위해 OpenClaw에 RunAPI가 설정되어 있다면, 동일한 key로 GPT Image를 사용할 수 있습니다 — 추가 설정이 필요 없습니다. 2. **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를 제공하세요. 3. **결과 받기** — API는 즉시 task_id를 반환합니다. status가 completed로 변경될 때까지 task status 엔드포인트를 폴링한 후 응답에서 출력 이미지 URL을 가져오세요. GPT Image 2는 해상도에 따라 일반적으로 10~30초 내에 완료됩니다. ## Parameters | Parameter | Type | Description | |-----------|------|-------------| | `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 하나 이상. | ## FAQ ### OpenClaw에서 GPT Image 2를 사용할 수 있나요? 네. OpenClaw 에이전트는 RunAPI text_to_image 엔드포인트를 통해 GPT Image 2를 호출합니다. model 필드를 gpt-image-2-text-to-image로 설정하고 채팅에 사용하는 동일한 RUNAPI_API_KEY로 요청을 보내세요. 추가 스킬이나 플러그인이 필요 없습니다. ### GPT Image 2와 GPT-4o Image의 차이점은 무엇인가요? 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가 투명 배경을 지원하나요? 네. GPT Image 2는 프롬프트에서 지시할 때 투명 배경이 있는 이미지를 출력할 수 있습니다. 이는 제품 사진, 로고, UI 요소에 유용합니다. 프롬프트에 투명도를 명시하세요 — 예: "transparent background가 있는 제품 사진." ### RunAPI에서 GPT Image 2 가격은 어떻게 책정되나요? GPT Image 2는 출력 해상도에 따라 이미지당 청구됩니다: 1k가 가장 저렴하고, 2k는 중간 요금이며, 4k가 가장 비쌉니다. text_to_image와 edit_image 모두 동일한 요금이 적용됩니다. 현재 이미지당 요금은 RunAPI 가격 페이지를 확인하세요. 실패한 생성은 청구되지 않습니다. ### GPT Image 2로 기존 이미지를 편집할 수 있나요? 네. model을 gpt-image-2-image-to-image로 설정하여 edit_image 엔드포인트를 사용하세요. source_image_urls에 소스 이미지 URL을 전달하고 프롬프트에 편집 내용을 설명하세요 — 예: "배경을 해변 석양으로 변경" 또는 "사람에게 빨간 모자 추가." GPT Image 2는 자연어 편집 지시를 따릅니다. ## Links - [OpenClaw 설정 가이드 →](https://runapi.ai/ko/openclaw) - [GPT Image 모델 →](https://runapi.ai/ko/models/gpt-image) - [Model catalog](https://runapi.ai/ko/models) - [API docs](https://runapi.ai/ko/docs)