OmniHuman API
오디오 기반 토킹 헤드 비디오, 인물 식별, 주체 마스크 감지를 위한 OmniHuman API 액세스.
curl -X POST https://runapi.ai/api/v1/omnihuman/audio_to_video \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "omnihuman-1.5-subject-detection",
"image_url": "https://cdn.runapi.ai/public/samples/portrait.jpg",
"audio_url": "https://cdn.runapi.ai/public/samples/voice.mp3"
}'
import { OmnihumanClient } from "@runapi.ai/omnihuman";
const client = new OmnihumanClient();
const result = await client.audioToVideo.run({
model: "omnihuman-1.5-subject-detection",
image_url: "https://cdn.runapi.ai/public/samples/portrait.jpg",
audio_url: "https://cdn.runapi.ai/public/samples/voice.mp3",
});
require "runapi/omnihuman"
client = RunApi::Omnihuman::Client.new
result = client.audio_to_video.run(
model: "omnihuman-1.5-subject-detection",
image_url: "https://cdn.runapi.ai/public/samples/portrait.jpg",
audio_url: "https://cdn.runapi.ai/public/samples/voice.mp3"
)
npx skills add runapi-ai/omnihuman -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
OmniHuman은 소스 이미지와 구동 오디오로 토킹 헤드 비디오를 생성합니다. 헬퍼 엔드포인트는 인물 영역을 식별하고 audio-to-video 요청에 전달할 수 있는 주체 마스크를 반환할 수 있습니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
변형
앱 개발을 위해 OmniHuman skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/omnihuman -g
Install the OmniHuman skill for this app: 1. Add runapi-ai/omnihuman with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
이 model skill로 구현하는 방법
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
OmniHuman의 위치
OmniHuman은 RunAPI의 Bytedance 카탈로그에 속하며 audio-to-video 생성과 human-identification, subject-detection 헬퍼를 통합 API, SDK, CLI, Bruno, 문서 표면으로 제공합니다.
RunAPI로 OmniHuman을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
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가 기본값입니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.