5s previewHappyHorse
Text- and image-to-video generation with clear per-second billing.
5s previewPrompt to video, in context
slow dolly shot through a lantern-lit alley
- Resolution
- 720P
- Duration
- 5s
Lantern alley shot
A slow, stable dolly through a misty alley with warm lantern parallax.
What you can build with HappyHorse
Prompt driven generation
Submit a concise prompt and get production-ready video output through one TTAPI job.
Core controls only
Keep integration simple with prompt, model, output settings, and callback handling.
Async result flow
Use polling or webhook callbacks so long-running generations do not block your UI.
Ready for product UI
Return HappyHorse results that can be displayed, stored, or passed into downstream workflows.
Per-action, in quota
Usage is metered in quota by model, action, and output settings.
Headers and submit parameters
Use the endpoint below with your TTAPI key and the request fields shown.
/happyhorse/api/v1/services/aigc/video-generation/video-synthesisGenerate video from a text prompt.
Official reference/happyhorse/api/v1/tasks/{task_id}Retrieve a HappyHorse task result.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
modelstringrequiredHappyHorse task model such as happyhorse-1.1-t2v.
input.promptstringconditionalText prompt for generation or editing.
input.mediaobject[]conditionalFirst-frame image, reference images, or source video for the selected workflow.
parameters.resolutionenumoptional720P or 1080P output.
parameters.durationintegeroptionalClip duration in seconds.
parameters.ratioenumoptionalOutput aspect ratio for supported workflows.
parameters.watermarkbooleanoptionalWhether to include the HappyHorse watermark.
parameters.seedintegeroptionalRandom seed from 0 to 2147483647.
From key to first result
Copy the resolved endpoint, authentication headers, and request body for this model.
curl --request POST \
--url https://api.ttapi.io/happyhorse/api/v1/services/aigc/video-generation/video-synthesis \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"model":"happyhorse-1.1-t2v","input":{"prompt":"slow dolly shot through a lantern-lit alley"},"parameters":{"resolution":"720P","duration":5,"watermark":false}}'