--- title: "Hermes Agent에서 RunAPI로 Seedance 사용하기 — 영상 API 가이드" url: "https://runapi.ai/ko/hermes-seedance.md" canonical: "https://runapi.ai/ko/hermes-seedance" locale: "ko" model: "seedance" --- # Hermes Agent에서 Seedance를 사용하세요. Seedance 2.0은 초당 약 $0.05부터 시작하는 초당 청구로 최대 1080p의 4~15초 영상을 생성합니다 — RunAPI 영상 모델 중 가장 낮은 초당 비용입니다. 멀티모달 레퍼런스 입력(이미지, 영상, 오디오 URL), 첫/마지막 프레임 제어, 네이티브 오디오 싱크를 지원합니다. Hermes Agent는 RunAPI 커스텀 엔드포인트를 통해 호출합니다 — custom:runapi를 한 번 설정하고 동일한 key를 재사용하세요. ## API example ```bash curl -X POST https://runapi.ai/api/v1/seedance/text_to_video \ -H "Authorization: Bearer $RUNAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedance-2.0", "prompt": "A ceramic coffee mug rotates slowly on a wooden table, steam rising, warm morning light from a window, cinematic", "duration_seconds": 8, "aspect_ratio": "16:9", "output_resolution": "1080p" }' ``` ### Response ```json { "task_id": "tsk_abc123", "status": "pending", "model": "seedance-2.0" } ``` ## How it works 1. **RunAPI 설정** — Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key와 base_url이 영상 생성을 처리합니다. 그렇지 않은 경우, base_url을 https://runapi.ai/v1로 설정하여 커스텀 프로바이더를 추가하고 hermes doctor를 실행하세요. 2. **Seedance text_to_video 호출** — model을 seedance-2.0으로 설정하여 text_to_video 엔드포인트에 POST 요청을 보내세요. 프롬프트, duration_seconds (4~15), aspect_ratio, output_resolution을 포함하세요. 선택적으로 멀티모달 제어를 위해 first_frame_image_url, reference_image_urls, 또는 reference_audio_urls를 첨부하세요. Hermes Agent는 custom:runapi 프로바이더를 통해 이를 전송합니다. 3. **결과 가져오기** — 엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 출력 영상 URL을 읽으세요. 청구는 생성된 영상의 길이와 해상도에 따라 초당 계산됩니다. ## Parameters | Parameter | Type | Description | |-----------|------|-------------| | `model` | `string` | 필수. seedance-2.0, seedance-2.0-fast, seedance-1.5-pro, seedance-v1-pro, seedance-v1-lite. | | `prompt` | `string` | 필수. 생성할 영상 장면의 텍스트 설명. | | `duration_seconds` | `integer` | 영상 길이(초). Seedance 2.0은 4~15초, v1 변형은 5초 또는 10초. | | `aspect_ratio` | `string` | 출력 화면 비율. 허용 값: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto. | | `output_resolution` | `string` | 영상 해상도. 허용 값: 480p, 720p, 1080p. 해상도가 높을수록 초당 비용이 더 많이 듭니다. | | `first_frame_image_url` | `string` | 선택 사항. 첫 번째 프레임으로 사용할 이미지 URL. 이미지-비디오 워크플로우를 활성화합니다. | | `last_frame_image_url` | `string` | 선택 사항. 마지막 프레임으로 사용할 이미지 URL. 종료 장면을 제한합니다. | | `reference_image_urls` | `array` | 선택 사항. 포즈, 깊이, 또는 엣지 가이던스를 위한 레퍼런스 이미지 URL. | | `reference_audio_urls` | `array` | 선택 사항. 생성된 영상의 네이티브 오디오 싱크를 위한 레퍼런스 오디오 파일 URL. | | `reference_video_urls` | `array` | 선택 사항. 모션 또는 스타일 전환을 위한 레퍼런스 영상 URL. | | `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL. | ## FAQ ### Hermes Agent에서 Seedance를 사용할 수 있나요? 네. Hermes Agent에서 base_url을 https://runapi.ai/v1로 설정하여 RunAPI를 커스텀 프로바이더로 설정한 후 model을 seedance-2.0으로 설정하여 text_to_video 엔드포인트를 호출하세요. 동일한 API key로 채팅과 영상 생성이 모두 처리됩니다. ### Seedance 초당 청구 방식은 어떻게 작동하나요? 실제 생성된 영상의 길이와 선택한 출력 해상도에 따라 청구됩니다. 480p 영상은 1080p보다 초당 비용이 저렴합니다. 비용은 작업 생성 시가 아니라 영상이 완료된 후 차감됩니다. ### Hermes Agent에 영상 생성을 위한 플러그인이 필요한가요? 아니요. Hermes Agent는 채팅 요청을 보내는 것과 동일한 방식으로 custom:runapi 프로바이더를 통해 HTTP 요청을 전송합니다. text_to_video 엔드포인트는 JSON 본문을 허용하고 작업 ID를 반환합니다. 추가 플러그인이나 확장이 필요 없습니다. ### Seedance가 이미지로부터 영상을 생성할 수 있나요? 네. 텍스트 프롬프트와 함께 first_frame_image_url 파라미터에 이미지 URL을 전달하세요. Seedance는 이미지를 시작 프레임으로 사용하고 거기서부터 모션을 생성합니다. 종료 부분을 제한하려면 last_frame_image_url 을 설정할 수도 있습니다. ### Seedance 2.0 영상은 얼마나 길 수 있나요? Seedance 2.0은 4~15초 사이의 영상을 생성합니다. duration_seconds 파라미터를 원하는 길이로 설정하세요. 구형 변형(v1-pro, v1-lite)은 5초 또는 10초의 고정 길이만 지원합니다. 더 긴 콘텐츠의 경우, 캐릭터 일관성 프롬프트와 첫/마지막 프레임 앵커링을 사용하여 여러 클립을 연결하세요. ## Links - [Hermes Agent 설정 가이드 →](https://runapi.ai/ko/hermes-agent) - [RunAPI의 Seedance →](https://runapi.ai/ko/models/seedance) - [Model catalog](https://runapi.ai/ko/models) - [API docs](https://runapi.ai/ko/docs)