curl -X POST https://api.vibetool.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4
}'
import requests
url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4
}
r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())
const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "happyhorse-1.0-reference-to-video",
image_url: "https://example.com/reference.png",
prompt: "a horse galloping through a meadow, cinematic lighting",
duration: 4
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4,
}
b, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}
{
"id": "gen_vid_xyz789",
"object": "video.generation",
"model": "happyhorse-1.0-reference-to-video",
"created_at": 1767072426,
"status": "pending",
"task_id": "vid_202512261557_a1b2c3d4"
}
{
"error": {
"message": "Invalid image URL or unsupported image format.",
"type": "invalid_request_error",
"param": "image_url",
"code": 400
}
}
HappyHorse Series
HappyHorse 1.0 Reference To Video
HappyHorse 1.0 is a top-ranked video generation model (720p/1080p) with per-second billing via Vibetool’s async API.
POST
/
v1
/
videos
/
generations
curl -X POST https://api.vibetool.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4
}'
import requests
url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4
}
r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())
const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "happyhorse-1.0-reference-to-video",
image_url: "https://example.com/reference.png",
prompt: "a horse galloping through a meadow, cinematic lighting",
duration: 4
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4,
}
b, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}
{
"id": "gen_vid_xyz789",
"object": "video.generation",
"model": "happyhorse-1.0-reference-to-video",
"created_at": 1767072426,
"status": "pending",
"task_id": "vid_202512261557_a1b2c3d4"
}
{
"error": {
"message": "Invalid image URL or unsupported image format.",
"type": "invalid_request_error",
"param": "image_url",
"code": 400
}
}
Pricing: See vibetool.ai/pricing for current rates.
Input Modalities
- Image – a reference image to animate (JPEG or PNG)
- Text – (optional) a prompt describing motion, scene, or style
Output Modality
- Video – an MP4 file (720p or 1080p, per-second billing)
Authorization
string
required
All APIs require Bearer Token authentication. Format:
Bearer YOUR_API_KEYRequest Body
string
required
The model identifier. Use
"happyhorse-1.0-reference-to-video".string
required
A publicly accessible URL to the input image (JPEG or PNG). Recommended minimum resolution is 256x256; maximum 2048x2048.
string
Optional text description of the desired video content (e.g., “a horse galloping through a meadow, cinematic lighting”).
number
Requested video duration in seconds (defaults to 4, subject to model limits). The model may adjust to its supported range.
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-reference-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.
curl -X POST https://api.vibetool.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4
}'
import requests
url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4
}
r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())
const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "happyhorse-1.0-reference-to-video",
image_url: "https://example.com/reference.png",
prompt: "a horse galloping through a meadow, cinematic lighting",
duration: 4
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "happyhorse-1.0-reference-to-video",
"image_url": "https://example.com/reference.png",
"prompt": "a horse galloping through a meadow, cinematic lighting",
"duration": 4,
}
b, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}
{
"id": "gen_vid_xyz789",
"object": "video.generation",
"model": "happyhorse-1.0-reference-to-video",
"created_at": 1767072426,
"status": "pending",
"task_id": "vid_202512261557_a1b2c3d4"
}
{
"error": {
"message": "Invalid image URL or unsupported image format.",
"type": "invalid_request_error",
"param": "image_url",
"code": 400
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Was this page helpful?