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초의 고정 길이만 지원합니다. 더 긴 콘텐츠의 경우, 캐릭터 일관성 프롬프트와 첫/마지막 프레임 앵커링을 사용하여 여러 클립을 연결하세요.

HERMES + SEEDANCE

Hermes Agent에서 Seedance를 사용하세요.

Seedance 2.0은 초당 약 $0.05부터 시작하는 초당 청구로 최대 1080p의 4~15초 영상을 생성합니다 — RunAPI 영상 모델 중 가장 낮은 초당 비용입니다. 멀티모달 레퍼런스 입력(이미지, 영상, 오디오 URL), 첫/마지막 프레임 제어, 네이티브 오디오 싱크를 지원합니다. Hermes Agent는 RunAPI 커스텀 엔드포인트를 통해 호출합니다 — custom:runapi를 한 번 설정하고 동일한 key를 재사용하세요.

API Key 받기 문서 읽기

하나의 API key · 텍스트-비디오 엔드포인트 · 초당 청구

Generate a product showcase video using Seedance 2.0 through RunAPI.

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/seedance/text_to_video
- Set model to "seedance-2.0".
- Set prompt to describe the video scene.
- Set duration_seconds to the desired length (4–15).
- Set aspect_ratio to "16:9" for landscape video.
- 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/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"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedance-2.0"
}

curl 명령어를 복사하여 테스트하세요 seedance

작동 방식

Hermes Agent에서 Seedance를 세 단계로 사용하기

RunAPI 설정

Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key와 base_url이 영상 생성을 처리합니다. 그렇지 않은 경우, base_url을 https://runapi.ai/v1로 설정하여 커스텀 프로바이더를 추가하고 hermes doctor를 실행하세요.

export RUNAPI_API_KEY=runapi_xxx

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 프로바이더를 통해 이를 전송합니다.

POST /api/v1/seedance/text_to_video

결과 가져오기

엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 출력 영상 URL을 읽으세요. 청구는 생성된 영상의 길이와 해상도에 따라 초당 계산됩니다.

GET /api/v1/seedance/text_to_video/tsk_abc123

파라미터

Seedance API 파라미터

파라미터	유형	설명
`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.

Hermes Agent의 Seedance란?

ByteDance의 Seedance 2.0은 단일 생성으로 오디오-비디오 통합 출력을 실현합니다. Hermes Agent의 custom:runapi provider를 통해 4~15초·최대 1080p의 동영상을 초당 과금으로 생성할 수 있으며, RunAPI 동영상 모델 중 초당 최저 비용입니다.