Skip to main content
POST
Pricing: See vibetool.ai/pricing for current rates.
HappyHorse 1.0 is a top-ranked video generation model that produces high‑quality 720p or 1080p video clips from a text prompt and an optional reference image. The model is accessed through Vibetool’s asynchronous API – you submit a generation request and poll for the result.

Input Modalities

  • Text – a descriptive prompt for the video content.
  • Image – (optional) a still image to guide the generation (e.g., style, character, background).

Output Modality

  • Video – an MP4 file at 720p or 1080p resolution (duration varies per request and model configuration).

Authorization

string
required
All APIs require Bearer Token authentication. Format: Bearer YOUR_API_KEY

Request Body

string
required
The model identifier. Use "happyhorse-1.0-text-to-video".
string
required
Text description of the desired video (e.g., “a horse galloping on a beach at sunset, cinematic lighting, 4K quality”).
string
A publicly accessible URL to an input image (JPEG or PNG) that helps guide the video generation. The image should be at least 256x256 pixels and no larger than 2048x2048.
number
Requested video duration in seconds (default is model‑specific, maximum depends on the plan). The model may adjust the duration to match its capabilities.
string
Desired output resolution. Options: "720p" or "1080p". Defaults to "720p".

Response Schema

string
required
Unique identifier for the generation task.
string
required
Type of object, always "video.generation".
string
required
The model used, e.g., "happyhorse-1.0-text-to-video".
integer
required
Unix timestamp (seconds) of task creation.
string
required
Initial status: "pending" or "processing". Use the Get Video Status endpoint to poll for completion.
string
required
The task ID to query in the status endpoint.
Once the task is created, poll the Get Video Status endpoint using the task_id until the status becomes "completed", at which point the video URL will be available in the response.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

Use happyhorse-1.0-text-to-video.

Available options:
happyhorse-1.0-text-to-video
prompt
string
required

Text description of the video to generate

image_url
string<uri>

Optional reference image URL

duration
number

Duration in seconds

resolution
string

Output resolution tier

Response

Task created

id
string

Unique identifier for the generation task

object
string
Example:

"video.generation"

model
string
created_at
integer

Unix timestamp (seconds)

status
enum<string>

Initial task status

Available options:
pending,
processing
task_id
string

Task ID for the status polling endpoint