Bytedance · 유틸리티

OpenClaw x OmniHuman

OmniHuman은 RunAPI의 Bytedance 카탈로그에 속하며 audio-to-video 생성과 human-identification, subject-detection 헬퍼를 통합 API, SDK, CLI, Bruno, 문서 표면으로 제공합니다.

3 variants 최저 $0.32 / 초 상업적 사용 지원

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 omnihuman-1.5를 사용하세요: 초상 이미지와 구동 오디오로 만드는 오디오 기반 토킹 헤드 비디오.

You have access to RunAPI task tools for OmniHuman.

Available OmniHuman models:
- omnihuman-1.5: 초상 이미지와 구동 오디오로 만드는 오디오 기반 토킹 헤드 비디오
  endpoints: /api/v1/omnihuman/audio_to_video
  request fields: model, source_image_url, source_audio_url, prompt
- omnihuman-1.5-human-identification: 소스 이미지의 인물 영역을 식별하는 헬퍼 작업
  endpoints: /api/v1/omnihuman/human_identification
  request fields: model, source_image_url
- omnihuman-1.5-subject-detection: OmniHuman 생성을 위한 주체 마스크를 반환하는 헬퍼 작업
  endpoints: /api/v1/omnihuman/subject_detection
  request fields: model, source_image_url

Use the model ID and endpoint that match the user's request.
Example prompt: 이 초상 이미지와 보이스오버로 720p 토킹 헤드 비디오를 만들고, 주체 마스크를 사용해 화자를 분리해 주세요.
/api/v1/omnihuman/audio_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/omnihuman/audio_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/omnihuman/audio_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/omnihuman/human_identification: Submit the task, poll for its status, then verify the completed output. POST /api/v1/omnihuman/human_identification를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/omnihuman/human_identification/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/omnihuman/subject_detection: Submit the task, poll for its status, then verify the completed output. POST /api/v1/omnihuman/subject_detection를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/omnihuman/subject_detection/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
omnihuman-1.5
/api/v1/omnihuman/audio_to_video
$0.32 / 초 모델 상세
omnihuman-1.5-human-identification
/api/v1/omnihuman/human_identification
무료 모델 상세
omnihuman-1.5-subject-detection
/api/v1/omnihuman/subject_detection
무료 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

OpenClaw + OmniHuman로 만들 수 있는 것

  • 제품 및 마케팅 클립

    작성한 브리프를 바탕으로 제품 페이지, 광고, 랜딩 페이지용 짧은 홍보 영상을 만듭니다.

  • 소셜 미디어 숏폼

    소셜 피드용 짧은 클립을 만들고, 같은 아이디어로 여러 버전을 시도한 뒤 고릅니다.

  • 이미지 애니메이션과 영상 편집

    모델이 이미지-영상 변환이나 영상 편집 엔드포인트를 제공하는 경우 정지 이미지를 움직이게 하거나 기존 영상을 수정합니다.

OmniHuman을(를) RunAPI + OpenClaw로 사용하는 이유

  • 3개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

OpenClaw + OmniHuman 자주 묻는 질문

OmniHuman audio-to-video에는 어떤 입력이 필요한가요?

Audio-to-video에는 소스 이미지 URL과 소스 오디오 URL이 필요합니다. 선택적 마스크 URL, prompt 지시, 해상도, 빠른 모드, seed, callback URL로 작업을 세부 조정할 수 있습니다.

Human Identification은 무엇을 반환하나요?

Human Identification은 하나의 소스 이미지를 분석하고 검토 또는 전처리에 사용할 인물 영역을 표시한 이미지 출력을 반환합니다.

Subject Detection은 무엇을 반환하나요?

Subject Detection은 하나의 소스 이미지를 분석하고 OmniHuman audio-to-video 요청의 `mask_urls`로 사용할 수 있는 마스크 출력을 반환합니다.

언제 `mask_urls`를 전달해야 하나요?

주체 분리를 더 강하게 하고 싶거나 같은 소스 이미지에 대해 이전 subject-detection 작업이 마스크를 생성한 경우 마스크 URL을 전달하세요.

어떤 출력 해상도를 지원하나요?

OmniHuman audio-to-video는 720p와 1080p 출력을 지원하며, 요청에서 해상도를 지정하지 않으면 1080p가 기본값입니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

OpenClaw에서 OmniHuman 사용 시작하기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기