Skip to main content
POST
/
v1
/
tasks
HappyHorse Series
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "callback_url": "<string>",
  "audio_setting": "<string>"
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "happyhorse-1.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

Video generation model on Alibaba Cloud Bailian. Single model, unified entry — just one happyhorse-1.0. The backend automatically routes to T2V / I2V / R2V / EDIT based on the fields you pass, no model id switching needed. Billed by resolution × duration, any integer between 3-15 seconds.

​
Pricing

ResolutionUnit Price5-second video
720P$0.138 / sec$0.69
1080P$0.244 / sec$1.22

​
Mode Routing

Fields PassedRouted ModeNotes
prompt onlyT2V (text-to-video)Frame ratio controlled by aspect_ratio
+ first_frame_image (single frame)I2V (image-to-video)aspect_ratio is ignored, follows the first frame’s ratio
+ image_urls (1-9 images)R2V (reference-to-video)Multi-image style / character consistency
+ video_urls (single-element array)EDIT (video editing)Can layer image_urls ≤5 as style references
Mutually exclusive fields — first_frame_image / image_urls / video_urls are pairwise mutually exclusive. Only video_urls + image_urls may be passed together (EDIT mode with style references layered on).

​
Examples

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0",
    "prompt": "A Shiba Inu in a spacesuit walking on the moon, cinematic lighting",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "happyhorse-1.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
After submission, poll status with GET /v1/tasks/{task_id}. See Task System for details.

​
Available Models

Model IDDescription
happyhorse-1.0Unified entry, T2V/I2V/R2V/EDIT auto-routing, 720P/1080P, 3-15 seconds

​
Common Parameters

​
model
string
required
Fixed value happyhorse-1.0
​
action
string
default:"generate"
Operation type. Usually no need to pass explicitly — the backend auto-routes based on media fields. Allowed values:
  • generate — text-to-video (T2V)
  • image2video — image-to-video (I2V), used with first_frame_image
  • reference — reference-to-video (R2V), used with image_urls
  • edit — video editing, used with video_url
  • reference_audio — used with audio_urls for audio-driven generation
​
prompt
string
Video description, up to 5000 characters. Required for T2V; optional as guidance for other modes
​
duration
integer
default:"5"
Video duration in seconds, any integer in 3-15. In EDIT mode, 0 means follow the source video’s duration
​
resolution
string
default:"720p"
Output resolution. Allowed values:
  • 720p
  • 1080p
​
aspect_ratio
string
default:"16:9"
Frame aspect ratio. Only effective in T2V; in I2V / R2V / EDIT it follows the source media. Allowed values:
  • 16:9 — landscape widescreen
  • 9:16 — portrait tall
  • 4:3 — landscape
  • 3:4 — portrait
  • 1:1 — square
​
image_urls
string[]
Reference image URL array, 1-9 images:
  • Triggers R2V mode (multi-image style / character consistency)
  • In EDIT mode, layered as style references (≤5 images)
​
first_frame_image
string
First-frame image URL, triggers I2V mode
​
video_urls
string[]
Source video URL array (single element), triggers EDIT mode:
  • base64 not currently supported
  • Must be a publicly downloadable URL
​
audio_urls
string[]
Reference audio URL array (reference_audio mode)
​
callback_url
string
Webhook callback URL, invoked when the task reaches a terminal state. See Callbacks

​
Model-Specific Parameters

​
audio_setting
string
default:"auto"
Audio setting, only effective in EDIT mode. Allowed values:
  • auto — automatically generate audio matching the edited video
  • origin — keep the source video’s original audio track

​
Resource Limits

ItemLimit
Reference imagesUp to 9, each ≤ 30MB, JPG/PNG/WEBP
Source video (EDIT)MP4/MOV, ≤ 100MB, 2-30 seconds
Reference audioWAV/MP3, ≤ 15MB, 3-30 seconds
OutputMP4, link valid for 24 hours