Wan 2.5 - Image to Video

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>",
    "enable_prompt_expansion": true,
    "negative_prompt": "<string>",
    "seed": 123
  }
}
'

import requests

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

payload = {
    "model": "<string>",
    "input": {
        "prompt": "<string>",
        "image_url": "<string>",
        "duration": "<string>",
        "resolution": "<string>",
        "enable_prompt_expansion": True,
        "negative_prompt": "<string>",
        "seed": 123
    }
}
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>',
      enable_prompt_expansion: true,
      negative_prompt: '<string>',
      seed: 123
    }
  })
};

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>',
        'enable_prompt_expansion' => true,
        'negative_prompt' => '<string>',
        'seed' => 123
    ]
  ]),
  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    \"enable_prompt_expansion\": true,\n    \"negative_prompt\": \"<string>\",\n    \"seed\": 123\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    \"enable_prompt_expansion\": true,\n    \"negative_prompt\": \"<string>\",\n    \"seed\": 123\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    \"enable_prompt_expansion\": true,\n    \"negative_prompt\": \"<string>\",\n    \"seed\": 123\n  }\n}"

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

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

POST

api

jobs

createTask

Wan 2.5 - Image to Video

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>",
    "enable_prompt_expansion": true,
    "negative_prompt": "<string>",
    "seed": 123
  }
}
'

import requests

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

payload = {
    "model": "<string>",
    "input": {
        "prompt": "<string>",
        "image_url": "<string>",
        "duration": "<string>",
        "resolution": "<string>",
        "enable_prompt_expansion": True,
        "negative_prompt": "<string>",
        "seed": 123
    }
}
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>',
      enable_prompt_expansion: true,
      negative_prompt: '<string>',
      seed: 123
    }
  })
};

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>',
        'enable_prompt_expansion' => true,
        'negative_prompt' => '<string>',
        'seed' => 123
    ]
  ]),
  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    \"enable_prompt_expansion\": true,\n    \"negative_prompt\": \"<string>\",\n    \"seed\": 123\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    \"enable_prompt_expansion\": true,\n    \"negative_prompt\": \"<string>\",\n    \"seed\": 123\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    \"enable_prompt_expansion\": true,\n    \"negative_prompt\": \"<string>\",\n    \"seed\": 123\n  }\n}"

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

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

Transform an input image into a dynamic video using the **Wan 2.5 - Image to Video ** model.

Create a Video Generation Task

POST /api/v1/jobs/createTask

Authentication

All API requests require a Bearer Token.

Authorization: Bearer YOUR_API_KEY

Parameters

Top-Level Parameters

Parameter	Type	Required	Description
`model`	string	Yes	Must be `wan/2-5-image-to-video`.
`input`	object	Yes	Input parameters for video generation.

string

required

Must be wan/2-5-image-to-video.

`input` Parameters

object

required

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

string

required

Use prompt to describe the video motion you want to generate.Maximum length: 800 characters.

string

required

Use the provided image URL as the 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 image types:

image/jpeg
image/png
image/webp

Maximum file size: 10 MB

string

default:"5"

Use duration to specify the length of the generated video in seconds.Supported values:

"5"
"10"

Default: "5"

string

default:"1080p"

Specify the resolution of the output video.Supported output resolutions:

720p
1080p

Default: 1080p

boolean

default:"true"

Whether to enable prompt rewriting using LLM.Default: true

string

Use negative_prompt to specify the content that should be avoided.Maximum length: 500 characters.

number

default:"0"

Random seed for reproducible generation.Note: If omitted, a random seed will be selected automatically.

Request

Request Body

The request body must be JSON and requires the model field.

{
  "model": "wan/2-5-image-to-video",
  "input": {
    "image_url": "https://example.com/input-image.jpg",
    "prompt": "Describe the video you want to generate.",
    "duration": "5",
    "resolution": "1080p",
    "enable_prompt_expansion": false,
    "negative_prompt":"Describe negative prompt to avoid content you want."
    "seed": 0,
  }
}

Response

Successful Response

A successful request returns a task ID that can be used to query the task status.

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.

​Create a Video Generation Task

​Authentication

​Parameters

​Top-Level Parameters

​input Parameters

​Request

​Request Body

​Response

​Successful Response

​Query Task Status

Get Task Details

​Error Response

​Response Codes

Create a Video Generation Task

Authentication

Parameters

Top-Level Parameters

`input` Parameters

Request

Request Body

Response

Successful Response

Query Task Status

Error Response

Response Codes