Skip to main content
POST
HappyHorse 1.1

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be happyhorse-1-1.

Available options:
happyhorse-1-1
prompt
string
required

Text prompt describing the video.

image_url
string<uri>

Optional first-frame image URL. If provided, runs image-to-video (aspect ratio follows the image); otherwise text-to-video. Requirements: JPEG/PNG/WEBP, >=300px, ratio 1:2.5-2.5:1, <10MB.

ratio
enum<string>
default:16:9

Aspect ratio. Text-to-video only; ignored when image_url is provided.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4
duration
integer
default:5

Video duration in seconds (3-15).

Required range: 3 <= x <= 15
resolution
enum<string>
default:720P

Output resolution.

Available options:
720P,
1080P
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required