HappyHorse Series

POST

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>"
}
'

import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
    "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>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>'
  })
};

fetch('https://www.qingbo.dev/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"audio_setting\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"audio_setting\": \"<string>\"\n}")
  .asString();

{
  "task_id": "task-wave1775285160b950328499",
  "model": "happyhorse-1.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

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

Resolution	Unit Price	5-second video
720P	`$0.138` / sec	`$0.69`
1080P	`$0.244` / sec	`$1.22`

Mode Routing

Fields Passed	Routed Mode	Notes
`prompt` only	T2V (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"
  }'

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": "Character slowly walking toward the camera",
    "first_frame_image": "https://cdn.example.com/portrait.jpg",
    "duration": 8,
    "resolution": "1080p"
  }'

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": "Keep the character consistent, running through a forest",
    "image_urls": [
      "https://cdn.example.com/char-1.jpg",
      "https://cdn.example.com/char-2.jpg"
    ],
    "duration": 6,
    "resolution": "1080p"
  }'

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",
    "action": "edit",
    "prompt": "Change the scene to a snowy day",
    "video_urls": ["https://cdn.example.com/source.mp4"],
    "audio_setting": "origin",
    "duration": 0,
    "resolution": "1080p"
  }'

{
  "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 ID	Description
`happyhorse-1.0`	Unified entry, T2V/I2V/R2V/EDIT auto-routing, 720P/1080P, 3-15 seconds

Common Parameters

string

required

Fixed value happyhorse-1.0

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

string

Video description, up to 5000 characters. Required for T2V; optional as guidance for other modes

integer

default:"5"

Video duration in seconds, any integer in 3-15. In EDIT mode, 0 means follow the source video’s duration

string

default:"720p"

Output resolution. Allowed values:

720p
1080p

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

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)

string

First-frame image URL, triggers I2V mode

string[]

Source video URL array (single element), triggers EDIT mode:

base64 not currently supported
Must be a publicly downloadable URL

string[]

Reference audio URL array (reference_audio mode)

string

Webhook callback URL, invoked when the task reaches a terminal state. See Callbacks

Model-Specific Parameters

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

Item	Limit
Reference images	Up to 9, each ≤ 30MB, JPG/PNG/WEBP
Source video (EDIT)	MP4/MOV, ≤ 100MB, 2-30 seconds
Reference audio	WAV/MP3, ≤ 15MB, 3-30 seconds
Output	MP4, link valid for 24 hours

Task System — task state machine / polling cadence / async push
Request & Response Format — common error codes / Headers / rate limits
Authentication — API Key issuance and usage

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>"
}
'

import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
    "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>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>'
  })
};

fetch('https://www.qingbo.dev/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"audio_setting\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"audio_setting\": \"<string>\"\n}")
  .asString();

{
  "task_id": "task-wave1775285160b950328499",
  "model": "happyhorse-1.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Pricing

Mode Routing

Examples

Available Models

Common Parameters

Model-Specific Parameters

Resource Limits

​Pricing

​Mode Routing

​Examples

​Available Models

​Common Parameters

​Model-Specific Parameters

​Resource Limits

​Related Docs

Pricing

Mode Routing

Examples

Available Models

Common Parameters

Model-Specific Parameters

Resource Limits

Related Docs