Alibaba · Video

Hermes Agent x HappyHorse

HappyHorse belongs to the Alibaba catalog on RunAPI and exposes canonical text-to-video, image-to-video, and edit-video capabilities across API, SDK, CLI, Bruno, and docs surfaces.

7 variants from $0.24 / second Commercial OK
Get API Key View Hermes Agent Docs

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use happyhorse-1.0-i2v when it matches the task: HappyHorse 1.0 image-to-video from one first-frame image.

You have access to RunAPI task tools for HappyHorse.

Available HappyHorse models:
- happyhorse-1.0-i2v: HappyHorse 1.0 image-to-video from one first-frame image
  endpoints: /api/v1/happyhorse/image_to_video
  request fields: model, first_frame_image_url, prompt
- happyhorse-1.0-r2v: HappyHorse 1.0 reference-guided video from 1-9 ordered images
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-1.0-t2v: HappyHorse 1.0 text-to-video at 720p or 1080p
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-character: 3-15s text-to-video clips guided by 1-9 ordered reference images
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-edit-video: Prompted source-video edits with optional reference images
  endpoints: /api/v1/happyhorse/edit_video
  request fields: model, prompt, source_video_url
- happyhorse-image-to-video: 3-15s image-to-video clips from one first-frame image
  endpoints: /api/v1/happyhorse/image_to_video
  request fields: model, first_frame_image_url, prompt
- happyhorse-text-to-video: 3-15s text-to-video clips at 720p or 1080p
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls

Use the model ID and endpoint that match the user's request.
Example prompt: Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night.
/api/v1/happyhorse/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/image_to_video and save the returned Task id.
GET /api/v1/happyhorse/image_to_video/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.
/api/v1/happyhorse/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/text_to_video and save the returned Task id.
GET /api/v1/happyhorse/text_to_video/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.
/api/v1/happyhorse/edit_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/edit_video and save the returned Task id.
GET /api/v1/happyhorse/edit_video/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
happyhorse-1.0-i2v
/api/v1/happyhorse/image_to_video
$0.24 / second Model detail
happyhorse-1.0-r2v
/api/v1/happyhorse/text_to_video
$0.24 / second Model detail
happyhorse-1.0-t2v
/api/v1/happyhorse/text_to_video
$0.24 / second Model detail
happyhorse-character
/api/v1/happyhorse/text_to_video
$0.41 / second Model detail
happyhorse-edit-video
/api/v1/happyhorse/edit_video
$0.48 / second Model detail
happyhorse-image-to-video
/api/v1/happyhorse/image_to_video
$0.41 / second Model detail
happyhorse-text-to-video
/api/v1/happyhorse/text_to_video
$0.41 / second Model detail

Verify

Poll until the task reaches a terminal status

Select <model-id> to generate verification commands.

Configuration

Guide endpoint: <endpoint>

Select <model-id> to generate a request with the endpoint's public input contract.
How it works

Get Started in 3 Steps

  1. Choose a model ID

    Select a public catalog model ID and review its endpoint and current starting price.

  2. Configure RunAPI

    Set RUNAPI_API_KEY before making the endpoint request.

  3. Verify the result

    For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.

What to Build with Hermes Agent + HappyHorse

  • Product and marketing clips

    Create short promotional clips for product pages, ads, and landing pages from a written brief.

  • Social media shorts

    Produce short clips for social feeds and try several takes of the same idea before choosing one.

  • Image animation and video edits

    Animate still images or change existing footage where the model offers image-to-video or video editing endpoints.

Why Use HappyHorse Through RunAPI + Hermes Agent

  • 7 variants, one API key

    Use one RunAPI connection to choose among the live model variants without changing your integration.

  • Clear usage pricing

    See current catalog pricing before you send a request, with no subscription or minimum spend required.

  • Automatic task workflows

    Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code.

Hermes Agent + HappyHorse Questions

What can HappyHorse create?

HappyHorse offers text-to-video from a prompt, character-guided text-to-video from a prompt plus ordered reference images, image-to-video from one first-frame image, and edit-video from one source clip.

What resolutions does HappyHorse support?

All HappyHorse video endpoints support 720p and 1080p output. 1080p is the default, while 720p is useful for drafts and social clips.

How long can HappyHorse videos be?

HappyHorse video generation endpoints support integer durations from 3 to 15 seconds, while edit-video accepts a 3-60 second source video.

How does image-to-video use the input image?

Image-to-video accepts exactly one public image URL and treats it as the first frame before generating motion from the prompt and settings.

How does the character model use reference images?

The character model accepts 1-9 public image URLs on the text-to-video endpoint; their order maps to character1, character2, and later references in the prompt.

How does edit-video use the source video?

Edit-video accepts one public MP4 or MOV source video, an edit instruction, and up to 5 optional reference images.

Can I reproduce a HappyHorse result?

You can pass a seed to make generation more deterministic for the same prompt, media, and resolution.

Which model ID should I use?

Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version.

Does this guide configure a chat model?

No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model.

Start using HappyHorse with Hermes Agent

Get API Key Read Quickstart

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us