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

# OpenClaw에서 Veo 3를 사용하세요.

Veo 3는 Google DeepMind의 영상 생성 모델로, 네이티브 오디오(동기화된 대화, 주변 소리, 음악)와 함께 최대 8초의 1080p 클립을 생성합니다. OpenClaw 에이전트는 채팅에 사용하는 것과 동일한 RunAPI key와 엔드포인트로 호출하며, 추가 스킬 설치가 필요 없습니다.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/veo_3_1/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "A woman walks through a bustling Tokyo street at night, neon signs reflecting on wet pavement. She speaks into her phone: I just arrived. Ambient city noise, distant car horns, light rain.",
    "duration_seconds": 8,
    "aspect_ratio": "16:9"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "veo-3.1"
}

```

## How it works

1. **RunAPI 설정** — RUNAPI_API_KEY 환경 변수를 설정하세요. OpenClaw에서 채팅용 RunAPI 프로바이더를 이미 설정했다면, 동일한 key가 영상 생성에도 사용됩니다 — 추가 설정이나 프로바이더 계정이 필요 없습니다.
2. **Veo 3 text_to_video 호출** — model을 veo-3.1로 설정하여 text_to_video 엔드포인트에 POST 요청을 보내세요. 장면 설명과 오디오 큐(대화, 주변 소리)가 포함된 프롬프트를 포함하세요. duration_seconds를 4, 6, 또는 8로 설정하고 aspect_ratio를 16:9 또는 9:16으로 설정하세요.
3. **결과 가져오기** — 엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 출력 영상 URL을 가져오세요. 영상에는 프롬프트에서 생성된 동기화된 오디오가 포함됩니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. veo-3.1 (표준 품질) 또는 veo-3.1-fast (저렴한 비용, 빠른 생성). |
| `prompt` | `string` | 필수. 시각적 액션, 카메라 움직임, 대화 또는 주변 소리를 위한 오디오 큐가 포함된 장면 설명. |
| `duration_seconds` | `integer` | 선택 사항. 영상 길이(초). 허용 값: 4, 6, 8. 기본값은 8. |
| `aspect_ratio` | `string` | 선택 사항. 출력 화면 비율. 허용 값: 16:9, 9:16, auto. |
| `input_mode` | `string` | 선택 사항. 생성 모드. text (기본값), first_and_last_frames (키프레임 가이드), 또는 reference (스타일 레퍼런스). |
| `first_frame_image_url` | `string` | 선택 사항. 첫 번째 프레임 이미지의 URL. input_mode가 first_and_last_frames일 때 사용합니다. |
| `last_frame_image_url` | `string` | 선택 사항. 마지막 프레임 이미지의 URL. input_mode가 first_and_last_frames일 때 사용합니다. |
| `reference_image_urls` | `array` | 선택 사항. 스타일 레퍼런스 이미지의 URL. input_mode가 reference일 때 사용합니다. |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL. |

## FAQ

### OpenClaw에서 Veo 3를 사용할 수 있나요?

네. OpenClaw 에이전트는 RunAPI Veo 3 text_to_video 엔드포인트를 직접 호출합니다. model을 veo-3.1로 설정하고 채팅에 사용하는 것과 동일한 RUNAPI_API_KEY로 요청을 보내세요. 추가 스킬, 플러그인 또는 Google Cloud 계정이 필요 없습니다.

### Veo 3는 영상과 함께 오디오를 어떻게 생성하나요?

Veo 3는 텍스트 프롬프트에서 네이티브로 동기화된 오디오를 생성합니다. 프롬프트에 대화를 따옴표로 포함하고 주변 소리나 음악을 설명하면 — 별도의 오디오 파이프라인 없이 매칭되는 오디오가 생성됩니다.

### veo-3.1과 veo-3.1-fast의 차이점은 무엇인가요?

두 모델 모두 최대 1080p의 네이티브 오디오가 포함된 영상을 생성합니다. veo-3.1은 전체 품질 파이프라인을 사용하며 생성당 비용이 더 높습니다. veo-3.1-fast는 일부 시각적 품질을 낮추는 대신 비용이 저렴하고 처리가 더 빠릅니다 — 초안 작업과 반복 작업에 적합합니다.

### 생성 후 Veo 3 영상을 확장하거나 업스케일할 수 있나요?

네. RunAPI는 Veo 3용 extend_video와 upscale_video 엔드포인트를 제공합니다. 클립을 확장하려면 원본 생성의 source_task_id를 전달하거나, 1080p 또는 4K 해상도로 업스케일하세요. 두 작업 모두 비동기로 처리되며 별도로 청구됩니다.

### 최대 영상 길이와 해상도는 얼마인가요?

Veo 3는 최대 1080p 기본 해상도로 4초, 6초, 또는 8초 클립을 생성합니다. upscale_video 엔드포인트를 사용하여 완료된 영상을 4K로 업스케일할 수 있습니다. 화면 비율 옵션은 16:9, 9:16, auto입니다.


## Links

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