Hermes Agent에서 Runway를 사용하세요.
Runway와 Runway Aleph는 720p 또는 1080p의 시네마틱 영상을 텍스트 또는 이미지 프롬프트로 생성합니다. Hermes Agent는 RunAPI 커스텀 엔드포인트를 통해 이 호출들을 라우팅합니다 — 하나의 key로 모든 Runway 변형을 지원합니다.
Use RunAPI to generate a video with Runway Gen-4.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/runway/text_to_video
- Set model to "runway".
- Set prompt to describe the video content.
- Set duration_seconds to 5 or 10.
- Set output_resolution to "720p" or "1080p".
- Optionally set first_frame_image_url to guide the opening frame.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the video URL from the response output.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "runway"
}
Hermes Agent에서 Runway를 세 단계로 사용하기
RunAPI 설정
Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key로 Runway를 지원합니다 — 추가 설정이 필요 없습니다.
export RUNAPI_API_KEY=runapi_xxx
Runway 엔드포인트 호출
/api/v1/runway/text_to_video에 model을 runway 또는 runway-aleph로 POST 요청을 보내세요. 프롬프트, duration_seconds (5 또는 10), 선택적으로 first_frame_image_url을 포함하세요. Hermes Agent는 custom:runapi 프로바이더를 통해 라우팅합니다.
POST /api/v1/runway/text_to_video
결과 가져오기
엔드포인트는 task_id를 반환합니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 영상 URL을 가져오세요. 생성에는 일반적으로 30~90초가 소요됩니다.
GET /api/v1/runway/text_to_video/tsk_abc123
Runway text_to_video 파라미터
| 파라미터 | 유형 | 설명 |
|---|---|---|
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. |
Hermes Agent의 Runway란?
Runway Gen-4는 영화감 있는 구도와 부드러운 움직임으로 제작급 동영상을 제공하며 빠르고 깔끔한 출력으로 알려져 있습니다. Hermes Agent의 custom:runapi provider를 통해 세계 일관성과 샷 간 캐릭터 일관성을 가진 5초 또는 10초·720p 또는 1080p의 동영상을 생성합니다. Runway Aleph는 기존 영상의 스타일을 변경하는 동영상→동영상 편집 기능을 추가합니다.
Runway 활용 사례
일관된 캐릭터가 있는 내러티브 콘텐츠
캐릭터가 각 클립에서 외모를 유지하는 멀티샷 동영상 시퀀스를 구성합니다. 참조 이미지로 캐릭터 세부 사항을 고정하고 Hermes Agent가 샷을 연결합니다.
광고 및 소셜 콘텐츠 제작
Instagram Reels·TikTok 클립·마이크로 광고를 대량 생성합니다. Hermes Agent는 다른 프롬프트로 여러 Runway 작업을 병렬 디스패치하고 모든 결과를 수집할 수 있습니다.
Aleph를 사용한 동영상 스타일 변환
Runway Aleph로 기존 영상을 변환합니다——원래 움직임을 유지하면서 비주얼 스타일·조명·환경을 변경합니다. source_video_url과 스타일 프롬프트를 전달해 클립을 리스타일합니다.
Runway + Hermes Agent 자주 묻는 질문
네. 요청 본문에서 model을 runway-aleph로 설정하세요. Hermes Agent는 동일한 custom:runapi 프로바이더 엔드포인트를 통해 요청을 보냅니다 — 모델 슬러그만 변경하면 됩니다. Runway Aleph는 추가 설정 없이 동일한 base URL에서 사용할 수 있습니다.
네. 텍스트 프롬프트와 함께 요청 본문에 first_frame_image_url을 포함하세요. runway와 runway-aleph 모델 모두 이미지 앵커를 허용합니다. 영상은 이미지에서 시작하여 거기서부터 앞으로 모션을 생성합니다.
Runway는 5초 또는 10초의 고정 길이를 지원합니다 — duration_seconds 파라미터에서 허용하는 두 가지 값입니다. 가변 길이 옵션은 없습니다. 더 긴 콘텐츠를 만들려면 각 클립의 마지막 프레임을 다음 클립의 first_frame_image_url로 사용하여 여러 Runway 호출을 연결하세요.
지금 Hermes Agent에서 Runway를 사용해보세요.
무료 RunAPI key를 발급받고, custom:runapi 프로바이더를 설정하여 Runway 또는 Runway Aleph로 시네마틱 영상을 생성하세요.