Vidu Image-to-Video

curl --request POST \
  --url https://octopusx.ai/vidu/ent/v2/img2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "audio": true,
  "voice_id": "<string>",
  "is_rec": true,
  "bgm": true,
  "duration": 123,
  "seed": 123,
  "resolution": "<string>",
  "off_peak": true,
  "watermark": true,
  "wm_position": 123,
  "wm_url": "<string>",
  "payload": "<string>",
  "meta_data": "<string>"
}
'

import requests

url = "https://octopusx.ai/vidu/ent/v2/img2video"

payload = {
    "model": "<string>",
    "images": [{}],
    "prompt": "<string>",
    "audio": True,
    "voice_id": "<string>",
    "is_rec": True,
    "bgm": True,
    "duration": 123,
    "seed": 123,
    "resolution": "<string>",
    "off_peak": True,
    "watermark": True,
    "wm_position": 123,
    "wm_url": "<string>",
    "payload": "<string>",
    "meta_data": "<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>',
    images: [{}],
    prompt: '<string>',
    audio: true,
    voice_id: '<string>',
    is_rec: true,
    bgm: true,
    duration: 123,
    seed: 123,
    resolution: '<string>',
    off_peak: true,
    watermark: true,
    wm_position: 123,
    wm_url: '<string>',
    payload: '<string>',
    meta_data: '<string>'
  })
};

fetch('https://octopusx.ai/vidu/ent/v2/img2video', 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://octopusx.ai/vidu/ent/v2/img2video",
  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>',
    'images' => [
        [
                
        ]
    ],
    'prompt' => '<string>',
    'audio' => true,
    'voice_id' => '<string>',
    'is_rec' => true,
    'bgm' => true,
    'duration' => 123,
    'seed' => 123,
    'resolution' => '<string>',
    'off_peak' => true,
    'watermark' => true,
    'wm_position' => 123,
    'wm_url' => '<string>',
    'payload' => '<string>',
    'meta_data' => '<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://octopusx.ai/vidu/ent/v2/img2video"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"images\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"audio\": true,\n  \"voice_id\": \"<string>\",\n  \"is_rec\": true,\n  \"bgm\": true,\n  \"duration\": 123,\n  \"seed\": 123,\n  \"resolution\": \"<string>\",\n  \"off_peak\": true,\n  \"watermark\": true,\n  \"wm_position\": 123,\n  \"wm_url\": \"<string>\",\n  \"payload\": \"<string>\",\n  \"meta_data\": \"<string>\"\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://octopusx.ai/vidu/ent/v2/img2video")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"images\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"audio\": true,\n  \"voice_id\": \"<string>\",\n  \"is_rec\": true,\n  \"bgm\": true,\n  \"duration\": 123,\n  \"seed\": 123,\n  \"resolution\": \"<string>\",\n  \"off_peak\": true,\n  \"watermark\": true,\n  \"wm_position\": 123,\n  \"wm_url\": \"<string>\",\n  \"payload\": \"<string>\",\n  \"meta_data\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/vidu/ent/v2/img2video")

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  \"images\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"audio\": true,\n  \"voice_id\": \"<string>\",\n  \"is_rec\": true,\n  \"bgm\": true,\n  \"duration\": 123,\n  \"seed\": 123,\n  \"resolution\": \"<string>\",\n  \"off_peak\": true,\n  \"watermark\": true,\n  \"wm_position\": 123,\n  \"wm_url\": \"<string>\",\n  \"payload\": \"<string>\",\n  \"meta_data\": \"<string>\"\n}"

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

{
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "created_at": 1774494511
}

POST

https://octopusx.ai

vidu

ent

img2video

Vidu Image-to-Video

curl --request POST \
  --url https://octopusx.ai/vidu/ent/v2/img2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "audio": true,
  "voice_id": "<string>",
  "is_rec": true,
  "bgm": true,
  "duration": 123,
  "seed": 123,
  "resolution": "<string>",
  "off_peak": true,
  "watermark": true,
  "wm_position": 123,
  "wm_url": "<string>",
  "payload": "<string>",
  "meta_data": "<string>"
}
'

import requests

url = "https://octopusx.ai/vidu/ent/v2/img2video"

payload = {
    "model": "<string>",
    "images": [{}],
    "prompt": "<string>",
    "audio": True,
    "voice_id": "<string>",
    "is_rec": True,
    "bgm": True,
    "duration": 123,
    "seed": 123,
    "resolution": "<string>",
    "off_peak": True,
    "watermark": True,
    "wm_position": 123,
    "wm_url": "<string>",
    "payload": "<string>",
    "meta_data": "<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>',
    images: [{}],
    prompt: '<string>',
    audio: true,
    voice_id: '<string>',
    is_rec: true,
    bgm: true,
    duration: 123,
    seed: 123,
    resolution: '<string>',
    off_peak: true,
    watermark: true,
    wm_position: 123,
    wm_url: '<string>',
    payload: '<string>',
    meta_data: '<string>'
  })
};

fetch('https://octopusx.ai/vidu/ent/v2/img2video', 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://octopusx.ai/vidu/ent/v2/img2video",
  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>',
    'images' => [
        [
                
        ]
    ],
    'prompt' => '<string>',
    'audio' => true,
    'voice_id' => '<string>',
    'is_rec' => true,
    'bgm' => true,
    'duration' => 123,
    'seed' => 123,
    'resolution' => '<string>',
    'off_peak' => true,
    'watermark' => true,
    'wm_position' => 123,
    'wm_url' => '<string>',
    'payload' => '<string>',
    'meta_data' => '<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://octopusx.ai/vidu/ent/v2/img2video"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"images\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"audio\": true,\n  \"voice_id\": \"<string>\",\n  \"is_rec\": true,\n  \"bgm\": true,\n  \"duration\": 123,\n  \"seed\": 123,\n  \"resolution\": \"<string>\",\n  \"off_peak\": true,\n  \"watermark\": true,\n  \"wm_position\": 123,\n  \"wm_url\": \"<string>\",\n  \"payload\": \"<string>\",\n  \"meta_data\": \"<string>\"\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://octopusx.ai/vidu/ent/v2/img2video")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"images\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"audio\": true,\n  \"voice_id\": \"<string>\",\n  \"is_rec\": true,\n  \"bgm\": true,\n  \"duration\": 123,\n  \"seed\": 123,\n  \"resolution\": \"<string>\",\n  \"off_peak\": true,\n  \"watermark\": true,\n  \"wm_position\": 123,\n  \"wm_url\": \"<string>\",\n  \"payload\": \"<string>\",\n  \"meta_data\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/vidu/ent/v2/img2video")

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  \"images\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"audio\": true,\n  \"voice_id\": \"<string>\",\n  \"is_rec\": true,\n  \"bgm\": true,\n  \"duration\": 123,\n  \"seed\": 123,\n  \"resolution\": \"<string>\",\n  \"off_peak\": true,\n  \"watermark\": true,\n  \"wm_position\": 123,\n  \"wm_url\": \"<string>\",\n  \"payload\": \"<string>\",\n  \"meta_data\": \"<string>\"\n}"

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

{
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "created_at": 1774494511
}

Vidu Image-to-Video

Vidu official image-to-video interface, submitted as application/json.

The route entry is POST /vidu/ent/v2/img2video.
Currently submitted as application/json.
Supports first-frame image video generation.
After successful submission, the task task_id and status are returned, and you can poll the result later with Query Task.

Supported Models

viduq3-pro: Efficiently generates high-quality audio and video content, making videos more vivid, realistic, and three-dimensional
viduq2-pro / viduq2-turbo: New models with good results and rich details
viduq2-pro-fast: Lowest price, fast generation speed
viduq1 / viduq1-classic: Clear visuals, stable camera movement
vidu2.0: Fast generation speed

Method and Path

POST /vidu/ent/v2/img2video

Request Example

curl -X POST https://octopusx.ai/vidu/ent/v2/img2video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-pro",
    "images": ["https://example.com/first-frame.png"],
    "prompt": "让人物向前走并微笑",
    "audio": true,
    "is_rec": false,
    "bgm": false,
    "duration": 5,
    "seed": 0,
    "resolution": "720p",
    "off_peak": false,
    "watermark": false
  }'

import requests

resp = requests.post(
    "https://octopusx.ai/vidu/ent/v2/img2video",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "viduq3-pro",
        "images": ["https://example.com/first-frame.png"],
        "prompt": "让人物向前走并微笑",
        "audio": True,
        "is_rec": False,
        "bgm": False,
        "duration": 5,
        "seed": 0,
        "resolution": "720p",
        "off_peak": False,
        "watermark": False
    },
    timeout=60,
)
print(resp.json())

Response Example

{
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "created_at": 1774494511
}

Authentication

Authorization: Bearer YOUR_API_KEY

Body

model

string

required

Model name. Supports viduq3-pro, viduq2-pro, viduq2-turbo, viduq2-pro-fast, viduq1, viduq1-classic, and vidu2.0.

images

array

required

First-frame image. Only 1 image is supported. Supports image Base64 encoding or image URL. Image formats: png, jpeg, jpg, webp. The image ratio must be less than 1:4 or 4:1, and the image size must not exceed 50 MB.

prompt

string

Text prompt. The text description for video generation. If you use the is_rec recommended prompt parameter, the model will ignore the prompt entered in this parameter.

audio

boolean

Audio and video direct output. true: output a video with dialogue and background sound; false: output a silent video.

voice_id

string

Voice ID. Used to determine the voice timbre in the video. If empty, the system will automatically recommend one. Note: does not take effect for q3 models.

is_rec

boolean

Whether to use recommended prompts. true: the system automatically recommends prompts (number of recommended prompts = 1); false: generate video based on the input prompt.

bgm

boolean

Background music. true: the system will automatically select suitable music from the preset BGM library and add it; false: do not add BGM.

duration

integer

Video duration (seconds). viduq2 series: default 5 seconds, optional 1-10 seconds.

seed

integer

Random seed. If not provided or set to 0, a random number is used. If manually set, the specified seed is used.

resolution

string

Resolution. The default value depends on the model and video duration. viduq2 (1-10 seconds): default 720p, optional 540p, 720p, 1080p.

off_peak

boolean

Off-peak mode. true: generate video during off-peak hours; false: generate video immediately.

watermark

boolean

Whether to add a watermark. true: add watermark; false: do not add watermark.

wm_position

integer

Watermark position. 1: top-left; 2: top-right; 3: bottom-right; 4: bottom-left.

wm_url

string

Watermark image URL. If not provided, the default watermark “Content generated by AI” is used.

payload

string

Pass-through parameter. No processing is performed; data is only transmitted.

meta_data

string

Metadata identifier. A JSON-formatted string, pass-through field.

Response

task_id

string

Task ID, used to query the task status.

status

string

Task status. Possible values: processing (in progress), failed (failed), completed (completed).

created_at

integer

Creation timestamp (Unix timestamp).

Vidu Text-to-Video Vidu Start and End Frame Video Generation

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

Vidu Image-to-Video

Vidu Image-to-Video

Supported Models

Method and Path

Request Example

Response Example

Authentication

Body

Response

​Vidu Image-to-Video

​Supported Models

​Method and Path

​Request Example

​Response Example

​Authentication

​Body

​Response

​Related APIs

Vidu Image-to-Video

Supported Models

Method and Path

Request Example

Response Example

Authentication

Body

Response

Related APIs