Wan 2.7 Video Generation

Create video generation task (Alibaba Wan compatible protocol)

curl --request POST \
  --url https://api.example.com/v1/alibaba/video/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "negative_prompt": "<string>",
    "audio_url": "<string>",
    "prompt": "<string>",
    "media": [
      {
        "type": "<string>",
        "url": "<string>",
        "reference_voice": "<string>"
      }
    ]
  },
  "parameters": {
    "audio_setting": "<string>",
    "prompt_extend": true,
    "resolution": "<string>",
    "ratio": "<string>",
    "duration": 123,
    "watermark": true,
    "seed": 123
  }
}
'

import requests

url = "https://api.example.com/v1/alibaba/video/generations"

payload = {
    "model": "<string>",
    "input": {
        "negative_prompt": "<string>",
        "audio_url": "<string>",
        "prompt": "<string>",
        "media": [
            {
                "type": "<string>",
                "url": "<string>",
                "reference_voice": "<string>"
            }
        ]
    },
    "parameters": {
        "audio_setting": "<string>",
        "prompt_extend": True,
        "resolution": "<string>",
        "ratio": "<string>",
        "duration": 123,
        "watermark": True,
        "seed": 123
    }
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    input: {
      negative_prompt: '<string>',
      audio_url: '<string>',
      prompt: '<string>',
      media: [{type: '<string>', url: '<string>', reference_voice: '<string>'}]
    },
    parameters: {
      audio_setting: '<string>',
      prompt_extend: true,
      resolution: '<string>',
      ratio: '<string>',
      duration: 123,
      watermark: true,
      seed: 123
    }
  })
};

fetch('https://api.example.com/v1/alibaba/video/generations', 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://api.example.com/v1/alibaba/video/generations",
  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' => [
        'negative_prompt' => '<string>',
        'audio_url' => '<string>',
        'prompt' => '<string>',
        'media' => [
                [
                                'type' => '<string>',
                                'url' => '<string>',
                                'reference_voice' => '<string>'
                ]
        ]
    ],
    'parameters' => [
        'audio_setting' => '<string>',
        'prompt_extend' => true,
        'resolution' => '<string>',
        'ratio' => '<string>',
        'duration' => 123,
        'watermark' => true,
        'seed' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "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://api.example.com/v1/alibaba/video/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"negative_prompt\": \"<string>\",\n    \"audio_url\": \"<string>\",\n    \"prompt\": \"<string>\",\n    \"media\": [\n      {\n        \"type\": \"<string>\",\n        \"url\": \"<string>\",\n        \"reference_voice\": \"<string>\"\n      }\n    ]\n  },\n  \"parameters\": {\n    \"audio_setting\": \"<string>\",\n    \"prompt_extend\": true,\n    \"resolution\": \"<string>\",\n    \"ratio\": \"<string>\",\n    \"duration\": 123,\n    \"watermark\": true,\n    \"seed\": 123\n  }\n}")

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

	req.Header.Add("Authorization", "<authorization>")
	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://api.example.com/v1/alibaba/video/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"negative_prompt\": \"<string>\",\n    \"audio_url\": \"<string>\",\n    \"prompt\": \"<string>\",\n    \"media\": [\n      {\n        \"type\": \"<string>\",\n        \"url\": \"<string>\",\n        \"reference_voice\": \"<string>\"\n      }\n    ]\n  },\n  \"parameters\": {\n    \"audio_setting\": \"<string>\",\n    \"prompt_extend\": true,\n    \"resolution\": \"<string>\",\n    \"ratio\": \"<string>\",\n    \"duration\": 123,\n    \"watermark\": true,\n    \"seed\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/alibaba/video/generations")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"negative_prompt\": \"<string>\",\n    \"audio_url\": \"<string>\",\n    \"prompt\": \"<string>\",\n    \"media\": [\n      {\n        \"type\": \"<string>\",\n        \"url\": \"<string>\",\n        \"reference_voice\": \"<string>\"\n      }\n    ]\n  },\n  \"parameters\": {\n    \"audio_setting\": \"<string>\",\n    \"prompt_extend\": true,\n    \"resolution\": \"<string>\",\n    \"ratio\": \"<string>\",\n    \"duration\": 123,\n    \"watermark\": true,\n    \"seed\": 123\n  }\n}"

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

{
  "request_id": "<string>",
  "output": {
    "task_id": "<string>",
    "task_status": "<string>"
  }
}

POST

alibaba

video

generations

Create video generation task (Alibaba Wan compatible protocol)

curl --request POST \
  --url https://api.example.com/v1/alibaba/video/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "negative_prompt": "<string>",
    "audio_url": "<string>",
    "prompt": "<string>",
    "media": [
      {
        "type": "<string>",
        "url": "<string>",
        "reference_voice": "<string>"
      }
    ]
  },
  "parameters": {
    "audio_setting": "<string>",
    "prompt_extend": true,
    "resolution": "<string>",
    "ratio": "<string>",
    "duration": 123,
    "watermark": true,
    "seed": 123
  }
}
'

import requests

url = "https://api.example.com/v1/alibaba/video/generations"

payload = {
    "model": "<string>",
    "input": {
        "negative_prompt": "<string>",
        "audio_url": "<string>",
        "prompt": "<string>",
        "media": [
            {
                "type": "<string>",
                "url": "<string>",
                "reference_voice": "<string>"
            }
        ]
    },
    "parameters": {
        "audio_setting": "<string>",
        "prompt_extend": True,
        "resolution": "<string>",
        "ratio": "<string>",
        "duration": 123,
        "watermark": True,
        "seed": 123
    }
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    input: {
      negative_prompt: '<string>',
      audio_url: '<string>',
      prompt: '<string>',
      media: [{type: '<string>', url: '<string>', reference_voice: '<string>'}]
    },
    parameters: {
      audio_setting: '<string>',
      prompt_extend: true,
      resolution: '<string>',
      ratio: '<string>',
      duration: 123,
      watermark: true,
      seed: 123
    }
  })
};

fetch('https://api.example.com/v1/alibaba/video/generations', 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://api.example.com/v1/alibaba/video/generations",
  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' => [
        'negative_prompt' => '<string>',
        'audio_url' => '<string>',
        'prompt' => '<string>',
        'media' => [
                [
                                'type' => '<string>',
                                'url' => '<string>',
                                'reference_voice' => '<string>'
                ]
        ]
    ],
    'parameters' => [
        'audio_setting' => '<string>',
        'prompt_extend' => true,
        'resolution' => '<string>',
        'ratio' => '<string>',
        'duration' => 123,
        'watermark' => true,
        'seed' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "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://api.example.com/v1/alibaba/video/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"negative_prompt\": \"<string>\",\n    \"audio_url\": \"<string>\",\n    \"prompt\": \"<string>\",\n    \"media\": [\n      {\n        \"type\": \"<string>\",\n        \"url\": \"<string>\",\n        \"reference_voice\": \"<string>\"\n      }\n    ]\n  },\n  \"parameters\": {\n    \"audio_setting\": \"<string>\",\n    \"prompt_extend\": true,\n    \"resolution\": \"<string>\",\n    \"ratio\": \"<string>\",\n    \"duration\": 123,\n    \"watermark\": true,\n    \"seed\": 123\n  }\n}")

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

	req.Header.Add("Authorization", "<authorization>")
	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://api.example.com/v1/alibaba/video/generations")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"negative_prompt\": \"<string>\",\n    \"audio_url\": \"<string>\",\n    \"prompt\": \"<string>\",\n    \"media\": [\n      {\n        \"type\": \"<string>\",\n        \"url\": \"<string>\",\n        \"reference_voice\": \"<string>\"\n      }\n    ]\n  },\n  \"parameters\": {\n    \"audio_setting\": \"<string>\",\n    \"prompt_extend\": true,\n    \"resolution\": \"<string>\",\n    \"ratio\": \"<string>\",\n    \"duration\": 123,\n    \"watermark\": true,\n    \"seed\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/alibaba/video/generations")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"negative_prompt\": \"<string>\",\n    \"audio_url\": \"<string>\",\n    \"prompt\": \"<string>\",\n    \"media\": [\n      {\n        \"type\": \"<string>\",\n        \"url\": \"<string>\",\n        \"reference_voice\": \"<string>\"\n      }\n    ]\n  },\n  \"parameters\": {\n    \"audio_setting\": \"<string>\",\n    \"prompt_extend\": true,\n    \"resolution\": \"<string>\",\n    \"ratio\": \"<string>\",\n    \"duration\": 123,\n    \"watermark\": true,\n    \"seed\": 123\n  }\n}"

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

{
  "request_id": "<string>",
  "output": {
    "task_id": "<string>",
    "task_status": "<string>"
  }
}

This endpoint is fully compatible with the Alibaba Wan (DashScope) protocol, so you can reuse the parameter structure from the official documentation. The X-DashScope-Async header is not required because async semantics are built into the gateway. model must be a platform model identifier (e.g. wan2.7-t2v / wan2.7-i2v / wan2.7-r2v / wan2.7-videoedit), which the gateway rewrites to the channel model name after routing.

Request structure

The request body consists of three parts:

model: platform model identifier (required)
input: input content, including prompt / negative_prompt / audio_url and the media element list media (first frame / last frame / reference image / reference video / video to edit; accepts public URLs or base64 data URIs, with reference_voice to specify the subject’s voice timbre)
parameters: generation parameters, including resolution / ratio / duration / watermark / seed / prompt_extend / audio_setting

audio_setting is only effective for video editing models: auto (default) lets the model decide whether to regenerate audio based on the prompt; origin forcibly keeps the original sound of the input video.

Authentication

Include the Authorization header in the format Bearer YOUR_API_KEY.

Supported Video Models

Model Identifier	Model Type	Model Description
wan2.7-t2v	Text to Video	Based on text generation video
wan2.7-i2v	Image to Video	Based on image generation video
wan2.7-r2v	Reference Video	Based on reference generation video
wan2.7-videoedit	Video Edit	Edit input video

Quick example

import requests

url = "https://api.haitoken.ai/v1/alibaba/video/generations"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "model": "wan2.7-t2v",
    "input": {
        "prompt": "A golden retriever runs along the beach at sunset, camera slowly tracking"
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5,
        "watermark": False,
        "prompt_extend": True
    }
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const response = await fetch('https://api.haitoken.ai/v1/alibaba/video/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'wan2.7-t2v',
    input: {
      prompt: 'A golden retriever runs along the beach at sunset, camera slowly tracking'
    },
    parameters: {
      resolution: '720P',
      ratio: '16:9',
      duration: 5,
      watermark: false,
      prompt_extend: true
    }
  })
});

const data = await response.json();
console.log(data);

curl -X POST 'https://api.haitoken.ai/v1/alibaba/video/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "wan2.7-t2v",
    "input": {
      "prompt": "A golden retriever runs along the beach at sunset, camera slowly tracking"
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "prompt_extend": true
    }
  }'

A successful creation returns the task ID:

{
  "request_id": "8f3d2c1a-9b7e-4f5a-8c2d-1e6f0a9b3c5d",
  "output": {
    "task_id": "cgt-20260730120000-a1b2c3",
    "task_status": "PENDING"
  }
}

Next steps

See Query Wan video task to retrieve generation results
See Video generation for the unified protocol
See the HappyHorse protocol for HappyHorse compatible parameters
See the model list for available video models

Headers

Authorization

string

required

API Key token (Bearer sk-xxx)

Content-Type

string

Body

application/json

model

string

required

Platform model identifier (e.g. wan2.7-t2v / wan2.7-i2v / wan2.7-r2v / wan2.7-videoedit), rewritten to the channel model name by the gateway after routing

input

object

Input content (prompt and media elements)

Show child attributes

parameters

object

Generation parameters

Show child attributes

Response

200 - application/json

request_id

string

Gateway request ID

output

object

Task output

Show child attributes

Quick start

API documentation

AI tool integration

Other

Wan 2.7 Video Generation

Request structure

Authentication

Supported Video Models

Quick example

Next steps

Headers

Body

Response

​Request structure

​Authentication

​Supported Video Models

​Quick example

​Next steps

Headers

Body

Response

Request structure

Authentication

Supported Video Models

Quick example

Next steps