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

# Hermes Agent에서 Runway를 사용하세요.

Runway와 Runway Aleph는 720p 또는 1080p의 시네마틱 영상을 텍스트 또는 이미지 프롬프트로 생성합니다. Hermes Agent는 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 설정** — Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key로 Runway를 지원합니다 — 추가 설정이 필요 없습니다.
2. **Runway 엔드포인트 호출** — /api/v1/runway/text_to_video에 model을 runway 또는 runway-aleph로 POST 요청을 보내세요. 프롬프트, duration_seconds (5 또는 10), 선택적으로 first_frame_image_url을 포함하세요. Hermes Agent는 custom:runapi 프로바이더를 통해 라우팅합니다.
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

### Hermes Agent에서 Runway Aleph를 사용할 수 있나요?

네. 요청 본문에서 model을 runway-aleph로 설정하세요. Hermes Agent는 동일한 custom:runapi 프로바이더 엔드포인트를 통해 요청을 보냅니다 — 모델 슬러그만 변경하면 됩니다. Runway Aleph는 추가 설정 없이 동일한 base URL에서 사용할 수 있습니다.

### Hermes Agent에서 Runway가 이미지-비디오를 지원하나요?

네. 텍스트 프롬프트와 함께 요청 본문에 first_frame_image_url을 포함하세요. runway와 runway-aleph 모델 모두 이미지 앵커를 허용합니다. 영상은 이미지에서 시작하여 거기서부터 앞으로 모션을 생성합니다.

### Runway 영상의 최소 또는 최대 길이가 있나요?

Runway는 5초 또는 10초의 고정 길이를 지원합니다 — duration_seconds 파라미터에서 허용하는 두 가지 값입니다. 가변 길이 옵션은 없습니다. 더 긴 콘텐츠를 만들려면 각 클립의 마지막 프레임을 다음 클립의 first_frame_image_url로 사용하여 여러 Runway 호출을 연결하세요.


## Links

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