Hailuo 2.3 Pro

curl --request POST \
  --url https://whollyapi.com/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "prompt": "<string>",
    "image_url": "<string>",
    "duration": "<string>",
    "resolution": "<string>"
  }
}
'

import requests

url = "https://whollyapi.com/api/v1/jobs/createTask"

payload = {
    "model": "<string>",
    "input": {
        "prompt": "<string>",
        "image_url": "<string>",
        "duration": "<string>",
        "resolution": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    input: {
      prompt: '<string>',
      image_url: '<string>',
      duration: '<string>',
      resolution: '<string>'
    }
  })
};

fetch('https://whollyapi.com/api/v1/jobs/createTask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://whollyapi.com/api/v1/jobs/createTask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'input' => [
        'prompt' => '<string>',
        'image_url' => '<string>',
        'duration' => '<string>',
        'resolution' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://whollyapi.com/api/v1/jobs/createTask"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"resolution\": \"<string>\"\n  }\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://whollyapi.com/api/v1/jobs/createTask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"resolution\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://whollyapi.com/api/v1/jobs/createTask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"resolution\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "msg": "<string>",
  "data": {
    "taskId": "<string>"
  }
}

POST

api

jobs

createTask

Hailuo 2.3 Pro

curl --request POST \
  --url https://whollyapi.com/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "prompt": "<string>",
    "image_url": "<string>",
    "duration": "<string>",
    "resolution": "<string>"
  }
}
'

import requests

url = "https://whollyapi.com/api/v1/jobs/createTask"

payload = {
    "model": "<string>",
    "input": {
        "prompt": "<string>",
        "image_url": "<string>",
        "duration": "<string>",
        "resolution": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    input: {
      prompt: '<string>',
      image_url: '<string>',
      duration: '<string>',
      resolution: '<string>'
    }
  })
};

fetch('https://whollyapi.com/api/v1/jobs/createTask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://whollyapi.com/api/v1/jobs/createTask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'input' => [
        'prompt' => '<string>',
        'image_url' => '<string>',
        'duration' => '<string>',
        'resolution' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://whollyapi.com/api/v1/jobs/createTask"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"resolution\": \"<string>\"\n  }\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://whollyapi.com/api/v1/jobs/createTask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"resolution\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://whollyapi.com/api/v1/jobs/createTask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"resolution\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "msg": "<string>",
  "data": {
    "taskId": "<string>"
  }
}

Generate videos from a source image using the hailuo/2-3-image-to-video-pro model.

Authentication

All API requests require a Bearer Token.

Authorization: Bearer YOUR_API_KEY

Create a Video Generation Task

Submit an image-to-video generation task using the endpoint below.

POST /api/v1/jobs/createTask

Request Body

Field	Type	Required	Description
`model`	string	Yes	The model used for video generation.
`input`	object	Yes	Input parameters for the video generation task.

string

required

Must be hailuo/2-3-image-to-video-pro.

object

required

Input Parameters

The input object contains the parameters used to generate the video.

string

required

Use prompt to describe the desired video animation you want to generate.Maximum length: 5000 characters.

string

required

Use image_url for the video’s first frame.The image_url must contain the URL of an uploaded image. The value must be an uploaded file URL, not the file content itself.Supported formats:

image/jpeg
image/png
image/webp

Maximum file size: 10 MB

string

default:"6"

Use duration to specify the length of the generated video in seconds.Note:- 10-second videos are not supported in 1080p resolution.Supported values:

"6"
"10"

Default: "6"

string

default:"768P"

Specify the resolution of the generated video.Supported values:

768P
1080P

Default: 768P

Example Request

{
  "model": "hailuo/2-3-image-to-video-pro",
  "input": {
    "prompt": "At sunset, two armored medieval knights engage in a fierce cinematic duel across a dusty desert battlefield, their detailed metal armor glowing with warm golden light as their swords collide in a burst of sparks, captured with dynamic camera movement, shallow depth of field, dramatic slow motion, volumetric lighting, realistic reflections, and an epic atmosphere.",
    "image_url": "https://demo.com/example2.png",
    "duration": "6",
    "resolution": "768P",
  }
}

Response

Successful Response

number

Response status code.

string

Response message. Contains the error description when the request fails.Example: success

object

required

The task data object containing task id.

string

required

The unique identifier for this task.Example: task_123456

Query Task Status

After submitting a task, use the unified query endpoint to check the task progress and retrieve the generated results.

Get Task Details

Check task status, monitor generation progress, and retrieve results.

Error Response

{
  "code": 500,
  "msg": "Server Error - An unexpected error occurred while processing the request",
  "data": null
}

Response Codes

Code	Meaning
`200`	Success — the request was successfully processed.
`401`	Unauthorized — authentication credentials are missing or invalid.
`402`	Insufficient Credits — the account does not have enough credits.
`404`	Not Found — the requested resource or interface does not exist.
`408`	Upstream service issue — no result has been returned for over 10 minutes.
`422`	Validation Error — request parameters failed validation.
`429`	Rate Limited — request frequency limit has been exceeded.
`433`	Request Limit — sub-key usage exceeded the limit.
`455`	Service Unavailable — system is undergoing maintenance.
`500`	Server Error — an unexpected error occurred while processing the request.
`501`	Generation Failed — content generation failed.
`505`	Feature Disabled — the requested feature is disabled.

​Authentication

​Create a Video Generation Task

​Request Body

​Input Parameters

​Example Request

​Response

​Successful Response

​Query Task Status

Get Task Details

​Error Response

​Response Codes

Authentication

Create a Video Generation Task

Request Body

Input Parameters

Example Request

Response

Successful Response

Query Task Status

Error Response

Response Codes