Metadata-Version: 2.4
Name: runapi-omnihuman
Version: 0.1.2
Summary: RunAPI OmniHuman SDK for audio-to-video and image helper workflows in JavaScript, Python, Ruby, Go, Java, and PHP
Project-URL: Homepage, https://runapi.ai/models/omnihuman
Project-URL: Documentation, https://runapi.ai/docs#sdk-omnihuman
Project-URL: Source, https://github.com/runapi-ai/omnihuman-sdk
Project-URL: Issues, https://github.com/runapi-ai/omnihuman-sdk/issues
Project-URL: Changelog, https://github.com/runapi-ai/omnihuman-sdk/blob/main/CHANGELOG.md
Project-URL: Release Notes, https://github.com/runapi-ai/omnihuman-sdk/releases/tag/python%2Fv0.1.2
Author-email: RunAPI <contact@runapi.ai>
License-Expression: Apache-2.0
Keywords: api,audio-to-video,golang,gradle,java,maven,omnihuman,omnihuman-api,python,ruby,runapi,runapi-ai,sdk,typescript,video-api,video-generation
Requires-Python: >=3.9
Requires-Dist: runapi-core>=0.2.1
Description-Content-Type: text/markdown

# OmniHuman Python SDK for RunAPI

The OmniHuman Python SDK is the language-specific package for OmniHuman on RunAPI. Use this package for audio-driven talking-head video generation, human identification, and subject-mask detection when your application needs request bodies, task status lookup, and consistent RunAPI errors in Python.

This README is the Python package guide inside the public `omnihuman-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/omnihuman; for API reference, use https://runapi.ai/docs#omnihuman; for SDK docs, use https://runapi.ai/docs#sdk-omnihuman.

## Install

```bash
pip install runapi-omnihuman
```

## Quick start

```python
from runapi.omnihuman import OmnihumanClient

client = OmnihumanClient()  # reads RUNAPI_API_KEY, or pass api_key="sk-..."

task = client.audio_to_video.create(
    model="omnihuman-1.5",
    source_image_url="https://cdn.runapi.ai/public/samples/portrait.jpg",
    source_audio_url="https://cdn.runapi.ai/public/samples/voice.mp3",
    output_resolution="720p",
)
status = client.audio_to_video.get(task.id)
```

Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.

RunAPI-generated file URLs are temporary. Download and store generated videos, masks, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.

## Language notes

Pass parameters as keyword arguments and catch the `runapi.omnihuman` error classes when building video jobs or scripts. The available resources are `audio_to_video`, `human_identification`, and `subject_detection`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

## Links

- Model page: https://runapi.ai/models/omnihuman
- SDK docs: https://runapi.ai/docs#sdk-omnihuman
- Product docs: https://runapi.ai/docs#omnihuman
- Pricing and rate limits: https://runapi.ai/models/omnihuman/1.5
- Human identification: https://runapi.ai/models/omnihuman/1.5-human-identification
- Subject detection: https://runapi.ai/models/omnihuman/1.5-subject-detection
- Provider comparison: https://runapi.ai/providers/bytedance
- Full catalog: https://runapi.ai/models
- Repository: https://github.com/runapi-ai/omnihuman-sdk

## License

Licensed under the Apache License, Version 2.0.
