happyhorse-1.0-i2v
happyhorse-1.0-i2v is available through TTAPI. Text- and image-to-video generation with clear per-second billing.
Same input, two HappyHorse generations
Ink-wash bamboo duel
A white-robed heroine engages in a fierce battle in a bamboo forest, a peak ink-wash wuxia duel. White-Robed Heroine vs. Black-Clad Assassin. [Shot 1: Wide Shot · The Wind Rises] Visual: Distant mountains rendered in soft ink wash, endless green bamboo swaying across the landscape. Wind sweeps through the bamboo tops, leaves rolling like waves. Only shades of green-black remain between heaven and earth. Composition: High-angle distant view with ample negative space. Bamboo branches occupy two-thirds of the frame, with an empty and tranquil lower section. Action / Atmosphere: Stillness conceals danger; the moving wind foreshadows imminent killing intent. Subtitles / Sound Effects: Rustling bamboo leaves, wind gradually intensifying. [Shot 2: Medium Shot · The Heroine Enters the Forest] Visual: The white-robed heroine steps across bamboo stalks, sleeves and robes fluttering like a white crane gliding past. The tip of her sword lightly touches bamboo tops. Her figure is outlined with ink lines, hair flowing in the wind. Composition: Side profile entering the frame, the figure interwoven with bamboo, clean and elegant lines. Action: She taps a bamboo tip with her foot and lands lightly. Style: White robes remain as blank space; bamboo rendered in light ink, creating a clean contrast. [Shot 3: Close Shot · Killing Intent Appears] Visual: A black shadow bursts from the depths of the bamboo grove. The black robe is like ink, revealing only a pair of cold eyes. A brief flash of cold light glints from the short blade in hand. Composition: The black figure hides within bamboo shadows, partially concealed, creating strong oppression. Action: The black-clad assassin launches a surprise attack, blade cutting through the wind. [Shot 4: Extreme Close-Up · Blades Collide] Visual: The heroine blocks horizontally with her sword while the assassin's short blade strikes downward. The weapons collide, releasing a streak of pale ink-like energy (no metallic sparks, only ink diffusion). Composition: Close-up of crossing blades centered in the frame, maximum tension. Style: Dark ink blade, light ink sword, sharp and rigid linework. [Shot 5: Medium Shot · Agile Evasion] Visual: The heroine spins backward to evade. Bamboo branches are severed by the blade wind, broken stalks flying diagonally. She steps on a snapped bamboo tip, suspended in midair. Composition: Dynamic diagonal lines disrupt balance. Ink-wash dry-brush effects express speed. Action: Midair turn, sword aimed directly at the assassin's throat. [Shot 6: Overhead Shot · Encirclement in the Bamboo Forest] Visual: A top-down view. Green bamboo forms an intricate web of ink lines. A single white figure stands among surrounding black-clad enemies, black and white confronting one another. Composition: Symmetrical pressure. Negative space and dense bamboo create a breathing rhythm. [Shot 7: Close Shot · The Heroine Draws Her Sword] Visual: The heroine's eyes are calm and cold. Ink lines define her brows and eyes without excessive expression. With a twist of her wrist, the sword shoots forward like a white snake emerging from its den, piercing toward the dark figure. Composition: Facial close-up with the sword movement extending outward. Suggestive rather than realistic. [Shot 8: Dynamic Shot · Rain of Bamboo Leaves] Visual: The two fighters clash. Bamboo leaves are swept up by their energy, filling the air like an ink rain. Their figures weave between reality and illusion within the storm of leaves. Composition: Soft, blurred edges. Emphasis on mood over precise form. Ink diffusion conveys motion. Style: Motion and stillness united, resembling both dance and combat. [Shot 9: Freeze Frame · Victory Decided] Visual: The heroine's sword tip stops just before the assassin's throat. The assassin stands motionless. The wind ceases, and bamboo leaves drift slowly downward. Composition: Static confrontation with abundant negative space, embodying the spirit of wuxia. Ending: The ink gradually fades, leaving a lingering aftertaste.
What you can build with happyhorse-1.0-i2v
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/image-to-videoSubmit a HappyHorse I2V task.
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/image-to-video \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"model":"happyhorse-1.0-i2v","input":{"prompt":"slow dolly shot through a lantern-lit alley","media":[{"type":"first_frame","url":"https://example.com/first-frame.jpg"}]},"parameters":{"resolution":"720P","duration":5,"watermark":false}}'