MiniMax-H3 Official Format Query Task

curl --request GET \
  --url https://zx1.deepwl.net/v1/video/generations/{task_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://zx1.deepwl.net/v1/video/generations/{task_id}', 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://zx1.deepwl.net/v1/video/generations/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://zx1.deepwl.net/v1/video/generations/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/v1/video/generations/{task_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 0,
    "data": {
      "status": "running",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "SUCCESS",
    "progress": "100%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 1785125946,
    "data": {
      "status": "succeeded",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {
        "video_url": "https://your-cdn.example.com/h3-generated-2k-output.mp4"
      },
      "usage": {
        "total_seconds": 5,
        "input_seconds": 0,
        "output_seconds": 5,
        "input_image_count": 1,
        "input_audio_seconds": 6,
        "total_tokens": 273890,
        "prompt_tokens": 13500,
        "completion_tokens": 260390
      }
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "FAILURE",
    "progress": "100%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 1785125800,
    "fail_reason": "video description contains sensitive content (1026)",
    "data": {
      "status": "failed",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

{
  "error": {
    "code": "NotFound",
    "message": "task not found",
    "type": "new_api_error"
  }
}

GET

https://zx1.deepwl.net

video

generations

{task_id}

MiniMax-H3 Official Format Query Task

curl --request GET \
  --url https://zx1.deepwl.net/v1/video/generations/{task_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://zx1.deepwl.net/v1/video/generations/{task_id}', 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://zx1.deepwl.net/v1/video/generations/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://zx1.deepwl.net/v1/video/generations/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/v1/video/generations/{task_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 0,
    "data": {
      "status": "running",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "SUCCESS",
    "progress": "100%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 1785125946,
    "data": {
      "status": "succeeded",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {
        "video_url": "https://your-cdn.example.com/h3-generated-2k-output.mp4"
      },
      "usage": {
        "total_seconds": 5,
        "input_seconds": 0,
        "output_seconds": 5,
        "input_image_count": 1,
        "input_audio_seconds": 6,
        "total_tokens": 273890,
        "prompt_tokens": 13500,
        "completion_tokens": 260390
      }
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "FAILURE",
    "progress": "100%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 1785125800,
    "fail_reason": "video description contains sensitive content (1026)",
    "data": {
      "status": "failed",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

{
  "error": {
    "code": "NotFound",
    "message": "task not found",
    "type": "new_api_error"
  }
}

MiniMax-H3 Official Format Query Task

Query the task status, progress, and result video URL based on the task_id returned by Create Video (Official Format).

Method and Path

GET /v1/video/generations/{task_id}

Request Example

curl https://zx1.deepwl.net/v1/video/generations/424010985738629 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

resp = requests.get(
    "https://zx1.deepwl.net/v1/video/generations/424010985738629",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    timeout=30,
)
print(resp.json())

Response Example

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 0,
    "data": {
      "status": "running",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "SUCCESS",
    "progress": "100%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 1785125946,
    "data": {
      "status": "succeeded",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {
        "video_url": "https://your-cdn.example.com/h3-generated-2k-output.mp4"
      },
      "usage": {
        "total_seconds": 5,
        "input_seconds": 0,
        "output_seconds": 5,
        "input_image_count": 1,
        "input_audio_seconds": 6,
        "total_tokens": 273890,
        "prompt_tokens": 13500,
        "completion_tokens": 260390
      }
    }
  }
}

{
  "code": "success",
  "data": {
    "task_id": "424010985738629",
    "status": "FAILURE",
    "progress": "100%",
    "submit_time": 1785125529,
    "start_time": 1785125530,
    "finish_time": 1785125800,
    "fail_reason": "video description contains sensitive content (1026)",
    "data": {
      "status": "failed",
      "duration": 5,
      "resolution": "2K",
      "ratio": "16:9",
      "content": {},
      "usage": {}
    }
  }
}

{
  "error": {
    "code": "NotFound",
    "message": "task not found",
    "type": "new_api_error"
  }
}

Authentication

Authorization: Bearer YOUR_API_KEY

Path Parameters

string

required

Video generation task ID, consistent with the task_id returned by the creation endpoint.

Response

string

Response code, success on success.

string

Task ID.

string

Gateway task status: SUBMITTED, IN_PROGRESS, SUCCESS, FAILURE.

string

Progress string, such as 50% or 100%.

integer

Task submission time, Unix timestamp (seconds).

integer

Task start time, Unix timestamp (seconds).

integer

Task finish time, Unix timestamp (seconds); 0 when not finished.

string

Reason for failure, present only when status=FAILURE.

string

Upstream native status: queued, running, succeeded, failed, or cancelled.

integer

Generated video duration (seconds).

string

Output resolution, e.g. 2K.

string

Aspect ratio, e.g. 16:9.

string

Generated video URL (a temporary signed link with limited validity; download or persist it promptly).

object

Usage statistics. Includes total_seconds, input_seconds, output_seconds, input_image_count, input_audio_seconds, total_tokens, prompt_tokens, and completion_tokens.

object

Error object (returned only when the request fails), containing code, message, and type.

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

MiniMax-H3 Official Format Query Task

MiniMax-H3 Official Format Query Task

Method and Path

Request Example

Response Example

Authentication

Path Parameters

Response

​MiniMax-H3 Official Format Query Task

​Method and Path

​Request Example

​Response Example

​Authentication

​Path Parameters

​Response

​Related Endpoints

MiniMax-H3 Official Format Query Task

Method and Path

Request Example

Response Example

Authentication

Path Parameters

Response

Related Endpoints