HappyHorse
HappyHorse-Modelle werden über eine einheitliche, asynchrone Job-API aufgerufen. Starte einen Task mit POST /api/generate und frage dann GET /api/generate/{taskId} ab, bis er fertig ist. Diese Familie stellt 7 Endpunkte bereit.
Überblick
Jeder Endpunkt teilt sich dieselbe Hülle — nur model und die input-Felder ändern sich. Führe einen beliebigen im Playground des Modell-Markts aus.
Authentifizierung
Erstelle einen API-Schlüssel unter /api-keys und sende ihn als Bearer-Token. Anfragen aus dem Browser bei angemeldeter Sitzung funktionieren auch über das Session-Cookie.
Authorization: Bearer <YOUR_API_KEY>Task erstellen
POST https://api.lithovas.com/api/generateBody: { "model": "<slug>", "input": { … } }
Antwort: { "taskId": "<id>", "state": "waiting" }
Ergebnis abfragen
GET https://api.lithovas.com/api/generate/<taskId>Antwort: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }
state zu success oder fail wird. Fehlgeschlagene Tasks werden nicht berechnet.Endpunkte
| Modell | Task | model slug |
|---|---|---|
| HappyHorse | Text to Video | happyhorse/text-to-video |
| HappyHorse | Image to Video | happyhorse/image-to-video |
| HappyHorse | Video to Video | happyhorse/reference-to-video |
| HappyHorse | Video Editing | happyhorse/video-edit |
| HappyHorse 1.1 | Image to Video | happyhorse-1-1/image-to-video |
| HappyHorse 1.1 | Text to Video | happyhorse-1-1/text-to-video |
| HappyHorse 1.1 | Video to Video | happyhorse-1-1/reference-to-video |
HappyHorse · Text to Video
happyhorse/text-to-videopromptstringerforderlichText description of video to generate; max 5000 chars (2500 Chinese)
resolutionenum<string>optionalOutput video resolution setting
aspect_ratioenum<string>optionalOutput aspect ratio format
durationintegeroptionalVideo length in seconds (3-15 range)
seedintegeroptionalRandom seed for reproducible generation (0-2147483647)
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse/text-to-video",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 5,
"seed": 0
}
}'HappyHorse · Image to Video
happyhorse/image-to-videopromptstringoptionalText description for video generation (max 5000 chars)
image_urlsarray<string>erforderlichExactly one first-frame image URL (JPEG/PNG/WEBP, 300+ px)
resolutionenum<string>optionalOutput video resolution
durationintegeroptionalVideo length in seconds (3-15 range)
seedintegeroptionalRandom seed for reproducibility (0-2147483647)
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse/image-to-video",
"input": {
"prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
"image_urls": [
"https://example.com/input.jpg"
],
"resolution": "1080p",
"duration": 5,
"seed": 0
}
}'HappyHorse · Video to Video
happyhorse/reference-to-videopromptstringerforderlichText prompt describing the video to generate (any language)
reference_imagearray<string>erforderlichReference image URL list. Provide 1-9 images
resolutionenum<string>optionalOutput video resolution
aspect_ratioenum<string>optionalOutput aspect ratio
durationintegeroptionalOutput duration in seconds (integer, 3-15)
seedintegeroptionalRandom seed for reproducibility (if supported)
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse/reference-to-video",
"input": {
"prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
"reference_image": [
"https://example.com/input.jpg"
],
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 5,
"seed": 0
}
}'HappyHorse · Video Editing
happyhorse/video-editpromptstringerforderlichEdit instruction for intended change; max 5000 chars (2500 Chinese)
video_urlstringerforderlichInput video URL (MP4/MOV, 3-60s, max 2160px longer side)
reference_imagearray<string>optionalOptional reference images (0-5 URLs, JPEG/PNG/WEBP, >=300px)
resolutionenum<string>optionalOutput video resolution
audio_settingenum<string>optionalAudio handling strategy
seedintegeroptionalRandom seed for reproducibility (0-2147483647)
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse/video-edit",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"video_url": "https://example.com/reference.mp4",
"reference_image": [
"https://example.com/input.jpg"
],
"resolution": "1080p",
"audio_setting": "auto",
"seed": 0
}
}'HappyHorse 1.1 · Image to Video
happyhorse-1-1/image-to-videopromptstringoptionalDescribes video content to generate; max 5000 chars
image_urlsarray<string>erforderlichURL of first frame image (JPEG/PNG/WEBP, 300px+ min)
resolutionenum<string>optionalOutput video resolution
durationnumberoptionalVideo length in seconds; range [3, 15]
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1-1/image-to-video",
"input": {
"prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
"image_urls": [
"https://example.com/input.jpg"
],
"resolution": "1080p",
"duration": 5
}
}'HappyHorse 1.1 · Text to Video
happyhorse-1-1/text-to-videopromptstringerforderlichText description of the video; max 5000 chars (2500 Chinese)
resolutionenum<string>optionalOutput video resolution
aspect_ratioenum<string>optionalOutput video aspect ratio
durationnumberoptionalOutput video duration in seconds (3-15, whole numbers)
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1-1/text-to-video",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 5
}
}'HappyHorse 1.1 · Video to Video
happyhorse-1-1/reference-to-videopromptstringerforderlichDescription of desired elements and visual style for the video
reference_imagearray<string>erforderlichURLs of reference images (JPEG/PNG/WEBP, min 400px, max 20MB)
resolutionenum<string>optionalOutput video resolution tier
aspect_ratioenum<string>optionalVideo aspect ratio format
durationnumberoptionalVideo length in seconds (integer, 3-15 range)
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1-1/reference-to-video",
"input": {
"prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
"reference_image": [
"https://example.com/input.jpg"
],
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 5
}
}'