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

# Hermes Agent에서 Wan을 사용하세요.

Wan은 Alibaba의 오픈소스 영상 및 이미지 생성 모델로, Apache 2.0 라이선스이며 Artificial Analysis 텍스트-비디오 리더보드에서

## API example

```bash
curl -X POST https://runapi.ai/api/v1/task/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.7-text-to-video",
    "prompt": "A drone shot rising over terraced rice paddies at golden hour, mist rolling through the valleys, slow upward camera tilt",
    "output_resolution": "1080p"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "wan-2.7-text-to-video"
}

```

## How it works

1. **RunAPI 설정** — Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key와 base_url이 모든 Wan 엔드포인트를 처리합니다 — 추가 설정이 필요 없습니다.
2. **Wan 엔드포인트 호출** — model을 wan-2.7-text-to-video로 설정하고 output_resolution을 720p 또는 1080p로 설정하여 text_to_video에 POST 요청을 보내세요. 이미지-비디오는 first_frame_image_url과 함께 wan-2.7-image-to-video를 사용하세요. 음성 기반 영상은 source_audio_url과 source_image_url과 함께 wan-2.2-a14b-speech-to-video-turbo를 사용하세요. Hermes Agent는 custom:runapi 프로바이더를 통해 모든 요청을 라우팅합니다.
3. **결과 가져오기** — 엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 출력 영상 또는 이미지 URL을 읽으세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. wan-2.7-text-to-video, wan-2.6-text-to-video, wan-2.5-text-to-video, wan-2.2-a14b-text-to-video-turbo, 또는 wan-2.7-r2v. |
| `prompt` | `string` | 필수. 카메라 모션, 조명, 피사체 세부 사항을 포함한 원하는 영상 장면의 텍스트 설명. |
| `output_resolution` | `string` | 선택 사항. Wan 2.5+ 는 720p 또는 1080p. Wan 2.2는 480p와 580p도 허용. 기본값 720p. |
| `aspect_ratio` | `string` | 선택 사항. wan-2.7-r2v 전용. 허용 값: 16:9, 9:16, 1:1, 4:3, 3:4. |
| `duration_seconds` | `integer` | 선택 사항. wan-2.7-r2v 전용. 영상 길이(초), 2~10. |
| `seed` | `integer` | 선택 사항. 결정론적 출력을 위한 재현성 시드. |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL. |

## FAQ

### Hermes Agent에서 어떤 Wan 엔드포인트를 호출할 수 있나요?

모두 사용 가능합니다. text_to_video, image_to_video, speech_to_video, text_to_image (Wan 2.7 Image), edit_video, animate. RunAPI를 custom:runapi 프로바이더로 한 번 설정하면 요청당 엔드포인트와 모델 슬러그를 전환할 수 있습니다 — 예를 들어 영상은 wan-2.7-text-to-video, 4K 이미지 생성은 wan-2.7-image.

### Wan용으로 Hermes Agent에서 RunAPI를 커스텀 프로바이더로 설정하는 방법은?

base_url을 https://runapi.ai/v1로, API key를 RUNAPI_API_KEY로 설정하여 custom:runapi 프로바이더 항목을 추가하세요. 설정이 완료되면 모든 Wan 엔드포인트 — 및 113개 이상의 RunAPI 모델 전체 — 가 추가 플러그인 없이 동일한 프로바이더를 통해 접근 가능합니다.

### Wan 2.5, 2.6, 2.7의 차이점은 무엇인가요?

Wan 2.5는 1080p 출력을 도입했습니다. Wan 2.6은 영상 편집(R2V)과 더 빠른 생성을 위한 flash 변형을 추가했습니다. Wan 2.7은 이미지 생성(wan-2.7-image, wan-2.7-image-pro 최대 4K), 영상 편집(wan-2.7-edit-video), 그리고 Artificial Analysis 리더보드를 선도하는 향상된 텍스트-비디오 품질을 추가합니다.

### Wan의 음성-비디오 기능은 어떻게 작동하나요?

source_audio_url(오디오 파일)과 source_image_url(애니메이션할 얼굴)과 함께 wan-2.2-a14b-speech-to-video-turbo를 사용하세요. Wan은 얼굴이 오디오를 말하는 립싱크 영상을 생성합니다. 출력 해상도는 480p, 580p, 720p를 지원합니다.

### Wan은 오픈소스인가요? 자체 호스팅이 가능한가요?

네. Wan은 Alibaba가 Apache 2.0으로 출시했으며 모델 가중치가 공개되어 있습니다. RunAPI를 통해 GPU 설정 없이 API 한 번의 호출로 영상과 이미지를 생성할 수 있습니다. 개인 정보 보호를 위한 자체 호스팅 파이프라인이 필요하다면 동일한 가중치를 자체 인프라에서 실행할 수 있습니다.


## Links

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