HappyHorse API Python SDK for RunAPI
The HappyHorse Python SDK is the language-specific package for HappyHorse on RunAPI. Use this package for video generation, animation, and video editing workflows when your application needs request bodies, task status lookup, and consistent RunAPI errors in Python.
Install
pip install runapi-happyhorse
Quick start
from runapi.happyhorse import HappyHorseClient
client = HappyHorseClient() # reads RUNAPI_API_KEY, or pass api_key="sk-..."
video = client.text_to_video.run(
model="happyhorse-text-to-video",
prompt="A horse galloping along a beach at sunset, cinematic",
aspect_ratio="16:9",
output_resolution="1080p",
duration_seconds=5,
)
print(video.videos[0].url)
For image-to-video, call client.image_to_video.run with model="happyhorse-image-to-video" and a first_frame_image_url. For edit-video, call client.edit_video.run with model="happyhorse-edit-video". Use create to submit a task and return quickly, get to fetch the latest task state, and run to 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 images, videos, audio, 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.happyhorse error classes when building video jobs or scripts. The available resources are text_to_video, image_to_video, and edit_video. 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/happyhorse
- SDK docs: https://runapi.ai/docs/resources/sdks
- Product docs: https://runapi.ai/docs/api/happyhorse/text-to-video
- Image-to-video pricing and rate limits: https://runapi.ai/models/happyhorse/image-to-video
- Character pricing and rate limits: https://runapi.ai/models/happyhorse/character
- Edit-video pricing and rate limits: https://runapi.ai/models/happyhorse/edit-video
- Pricing and rate limits: https://runapi.ai/models/happyhorse/text-to-video
- Provider comparison: https://runapi.ai/providers/alibaba
- Full catalog: https://runapi.ai/models
License
Licensed under the Apache License, Version 2.0.
Metadata
Release files for runapi-happyhorse 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| runapi_happyhorse-0.3.0.tar.gz | 4.5 kB | Without provenance | Details for runapi_happyhorse-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| runapi_happyhorse-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for runapi_happyhorse-0.3.0-py3-none-any.whl |
Total release size: 11.2 kB
Release files / runapi_happyhorse-0.3.0.tar.gz
| Download URL | runapi_happyhorse-0.3.0.tar.gz |
|---|---|
| Size | 4.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b48d835d176d890ee0324a6aa22c8c1b9f5edbf4f6d92188cf1c8d7db57d5017
|
|
BLAKE2b-256 checksum How to use checksums |
394c9fa299108a99f0eed1f43dd84edc4f74c85fb200de297c29845a538177f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Omarchy","version":"4.0.1","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / runapi_happyhorse-0.3.0-py3-none-any.whl
| Download URL | runapi_happyhorse-0.3.0-py3-none-any.whl |
|---|---|
| Size | 6.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0935701b1a7f11167690e9a82dc9c8b16aea5d6e027da677c26d44e501826a10
|
|
BLAKE2b-256 checksum How to use checksums |
4d8f09d10fc2905b0f80c39a77eff9b33a0522b97cf365a342a1e56fbc6fff67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Omarchy","version":"4.0.1","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for runapi-happyhorse 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.