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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill"
}'
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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill"
}
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-video-edit",
image_url: "https://example.com/input.png",
prompt: "a cat stretching on a sunny windowsill"
})
});
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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill",
}
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_abc123",
"object": "video.generation",
"model": "happyhorse-1.0-video-edit",
"created_at": 1767072426,
"status": "pending",
"task_id": "vid_202512261557_b4fcbb08"
}
{
"error": {
"message": "Invalid image URL or unsupported image format.",
"type": "invalid_request_error",
"param": "image_url",
"code": 400
}
}
HappyHorse Series
HappyHorse 1.0 Video Edit
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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill"
}'
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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill"
}
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-video-edit",
image_url: "https://example.com/input.png",
prompt: "a cat stretching on a sunny windowsill"
})
});
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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill",
}
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_abc123",
"object": "video.generation",
"model": "happyhorse-1.0-video-edit",
"created_at": 1767072426,
"status": "pending",
"task_id": "vid_202512261557_b4fcbb08"
}
{
"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 still image to animate (JPEG or PNG)
- Text – (optional) a prompt describing the desired motion or scene
Output Modality
- Video – an MP4 file at up to 1080p resolution
Authorization
string
required
All APIs require Bearer Token authentication. Format:
Bearer YOUR_API_KEYRequest Body
string
required
The model identifier. Use
"happyhorse-1.0-video-edit".string
required
A publicly accessible URL to the input image (JPEG or PNG). The image should be at least 256x256 pixels and no larger than 2048x2048.
string
Optional text description of the desired video content (e.g., “a person waving, cinematic lighting”).
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-video-edit".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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill"
}'
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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill"
}
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-video-edit",
image_url: "https://example.com/input.png",
prompt: "a cat stretching on a sunny windowsill"
})
});
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-video-edit",
"image_url": "https://example.com/input.png",
"prompt": "a cat stretching on a sunny windowsill",
}
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_abc123",
"object": "video.generation",
"model": "happyhorse-1.0-video-edit",
"created_at": 1767072426,
"status": "pending",
"task_id": "vid_202512261557_b4fcbb08"
}
{
"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?