---
title: "OpenClaw에서 Grok Imagine 사용하기 via RunAPI — 이미지 & 비디오 API 가이드"
url: "https://runapi.ai/ko/openclaw-grok-imagine.md"
canonical: "https://runapi.ai/ko/openclaw-grok-imagine"
locale: "ko"
model: "grok-imagine"
---

# OpenClaw에서 Grok Imagine 사용하기.

Grok Imagine은 xAI의 이미지 및 비디오 생성 제품군으로 텍스트-이미지, 이미지-이미지, 텍스트-비디오, 이미지-비디오를 지원합니다. OpenClaw agent는 추가 skill 없이 채팅에 사용하는 동일한 RunAPI key와 /v1 endpoint로 호출합니다.

## 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": "grok-imagine-text-to-image",
    "prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "grok-imagine-text-to-image"
}

```

## How it works

1. **RunAPI 설정** — 쉘 프로파일에 RUNAPI_API_KEY 환경 변수를 설정하세요. OpenClaw에서 채팅용 RunAPI가 이미 설정되어 있다면, 동일한 key가 Grok Imagine에도 사용됩니다 — 추가 설정이 필요 없습니다.
2. **Grok Imagine 호출** — model을 grok-imagine-text-to-image로 설정하여 text_to_image endpoint에 POST 요청을 보내세요. 이미지를 설명하는 프롬프트를 포함하세요. 비디오의 경우 grok-imagine-text-to-video와 함께 text_to_video를 사용하세요.
3. **결과 가져오기** — API는 즉시 task_id를 반환합니다. status가 completed로 변경될 때까지 task status endpoint를 폴링한 뒤, 응답에서 출력 이미지 또는 비디오 URL을 가져오세요.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. 예) grok-imagine-text-to-image, grok-imagine-image-to-video. |
| `prompt` | `string` | 원하는 출력물에 대한 텍스트 설명. |
| `image_url` | `string` | 이미지-이미지 또는 이미지-비디오를 위한 소스 이미지 URL. |
| `aspect_ratio` | `string` | 선택 사항. 출력 종횡비, 예) 16:9, 1:1. |

## FAQ

### OpenClaw에서 Grok Imagine을 사용할 수 있나요?

네. OpenClaw에서 RunAPI가 이미 OpenAI 호환 provider로 설정되어 있다면, 동일한 API key와 /v1 endpoint가 Grok Imagine에도 사용됩니다. model을 grok-imagine-text-to-image로 설정하고 text_to_image endpoint를 호출하세요.

### Grok Imagine에 별도의 API key가 필요한가요?

아니요. 채팅과 다른 모델에 사용하는 동일한 RUNAPI_API_KEY가 Grok Imagine에도 사용됩니다. 하나의 key로 RunAPI 카탈로그의 113개 이상의 모델을 모두 사용할 수 있습니다.

### Grok Imagine은 비동기인가요, 동기인가요?

비동기입니다. API는 즉시 task_id를 반환합니다. task가 완료될 때까지 task status endpoint를 폴링하세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

### Grok Imagine 비용은 얼마인가요?

Grok Imagine은 RunAPI를 통해 task당 청구됩니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요. 실패한 생성에는 요금이 부과되지 않습니다.


## Links

- [OpenClaw 설정 가이드 →](https://runapi.ai/ko/openclaw)
- [Grok Imagine 모델 →](https://runapi.ai/ko/models/grok-imagine)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)