Skip to main content
POST
/
happyhorse-1.0-i2v
/
async
curl --request POST \
  --url https://api.modellix.ai/api/v1/alibaba/happyhorse-1.0-i2v/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_frame_image": "https://example.com/first.jpg"
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt

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

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json
​
first_frame_image
string
required

First frame image URL or base64 encoded image. Supports HTTP/HTTPS URLs and data URI format. Image requirements: Format: JPEG, JPG, PNG, WEBP; Resolution: Width and height >= 300 pixels; Aspect ratio: 1:2.5 ~ 2.5:1; File size: <= 10MB

Pattern: ^(https?://|data:image/)
Examples:

"https://example.com/first.jpg"

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."

​
prompt
string

Optional text prompt to guide video generation. Supports any language input. Maximum length: 5000 non-Chinese characters or 2500 Chinese characters (automatically truncated if exceeded)

Maximum string length: 5000
​
resolution
enum<string>
default:1080P

Video resolution level. The model automatically scales to the nearest total pixels based on the selected resolution. The output video aspect ratio approximately matches the input first frame

Available options:
720P,
1080P
​
duration
enum<integer>
default:5

Video duration in seconds. Must be an integer between 3 and 15

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
Required range: 3 <= x <= 15
​
seed
integer

Random seed for reproducibility. If not specified, the system generates a random seed. Note: Due to the probabilistic nature of model generation, even with the same seed, results may not be completely identical

Required range: 0 <= x <= 2147483647

Response

200 - application/json

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required