---
title: "OpenClaw에서 RunAPI로 Runway 사용하기 — 영상 API 가이드"
url: "https://runapi.ai/ko/openclaw-runway.md"
canonical: "https://runapi.ai/ko/openclaw-runway"
locale: "ko"
model: "runway"
---

# OpenClaw에서 Runway를 사용하세요.

Runway와 Runway Aleph는 720p 또는 1080p의 시네마틱 영상을 텍스트 또는 이미지 프롬프트로 생성합니다. OpenClaw 에이전트는 RunAPI 엔드포인트를 통해 이들을 호출합니다 — 하나의 key로 모든 Runway 변형을 지원하며 생성된 영상의 초당 청구됩니다.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/runway/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway",
    "prompt": "A drone shot rising over a misty mountain lake at sunrise, cinematic lighting",
    "duration_seconds": 10,
    "output_resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "runway"
}

```

## How it works

1. **RunAPI 설정** — 환경에 RUNAPI_API_KEY를 설정하세요. RunAPI가 이미 OpenClaw 채팅 프로바이더라면, 동일한 key로 Runway 영상을 지원합니다 — 추가 설정이 필요 없습니다.
2. **Runway 엔드포인트 호출** — /api/v1/runway/text_to_video에 model을 runway 또는 runway-aleph로 POST 요청을 보내세요. 프롬프트, duration_seconds (5 또는 10), 그리고 선택적으로 이미지 가이드 생성을 위한 first_frame_image_url을 포함하세요. Runway Aleph의 경우, model을 runway-aleph로 설정하고 텍스트 프롬프트를 전달하세요.
3. **결과 가져오기** — 엔드포인트는 task_id를 반환합니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 영상 URL을 가져오세요. 생성에는 일반적으로 30~90초가 소요됩니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. runway는 표준 품질용; runway-aleph는 차세대 시네마틱 출력용. |
| `prompt` | `string` | 장면 설명. 시각적 내용, 카메라 움직임, 분위기를 설명하세요. |
| `duration_seconds` | `integer` | 영상 길이(초). 허용 값: 5 또는 10. |
| `output_resolution` | `string` | 출력 화면 비율. 허용 값: 16:9, 9:16, 1:1. |
| `first_frame_image_url` | `string` | 시작 프레임으로 사용할 이미지 URL (이미지-비디오 모드). |
| `aspect_ratio` | `string` | 선택 사항. 출력 화면 비율. 허용 값: 16:9, 9:16, 1:1, 4:3, 3:4. |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL. |

## FAQ

### Runway와 Runway Aleph의 차이점은 무엇인가요?

Runway는 현재 세대 모델로 — 신뢰성 있고 빠르며 예측 가능한 비용의 시네마틱 출력을 제공합니다. Runway Aleph는 개선된 시각적 일관성과 더욱 반응적인 카메라 모션을 갖춘 차세대 변형입니다. Aleph는 초당 비용이 더 높지만 복잡한 장면에서 눈에 띄게 더 좋은 결과를 생성합니다.

### Runway가 이미지를 시작 프레임으로 사용할 수 있나요?

네. 텍스트 프롬프트와 함께 요청 본문에 first_frame_image_url을 전달하세요. Runway는 이미지를 시작 프레임으로 사용하고 거기서부터 앞으로 애니메이션을 생성합니다. 이는 runway와 runway-aleph 모델 모두에서 작동합니다.

### Runway의 초당 청구 방식은 어떻게 작동하나요?

Runway는 생성된 영상의 초당 요금을 부과합니다. 5초 클립은 10초보다 비용이 적습니다. 1080p는 720p보다 초당 비용이 더 높습니다. 비용은 작업이 완료될 때 RunAPI 잔액에서 차감됩니다.


## Links

- [OpenClaw 설정 가이드 →](https://runapi.ai/ko/openclaw)
- [RunAPI의 Runway →](https://runapi.ai/ko/models/runway)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)