Query Task Status

curl --request GET \
  --url https://api.aihubmax.com/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.aihubmax.com/v1/tasks/{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://api.aihubmax.com/v1/tasks/{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://api.aihubmax.com/v1/tasks/{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://api.aihubmax.com/v1/tasks/{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

{
  "id": "task-unified-1757165031-uyujaw3d",
  "object": "video.generation.task",
  "type": "video",
  "model": "lipsync-2",
  "status": "pending",
  "progress": 0,
  "created": 1757165031,
  "results": null,
  "error": null,
  "usage": {
    "credits_reserved": 5,
    "user_group": "default"
  }
}

GET

tasks

{task_id}

Query Task Status

curl --request GET \
  --url https://api.aihubmax.com/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.aihubmax.com/v1/tasks/{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://api.aihubmax.com/v1/tasks/{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://api.aihubmax.com/v1/tasks/{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://api.aihubmax.com/v1/tasks/{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

{
  "id": "task-unified-1757165031-uyujaw3d",
  "object": "video.generation.task",
  "type": "video",
  "model": "lipsync-2",
  "status": "pending",
  "progress": 0,
  "created": 1757165031,
  "results": null,
  "error": null,
  "usage": {
    "credits_reserved": 5,
    "user_group": "default"
  }
}

`results` Field Format

After a task completes (status=completed), results is an array whose structure varies by model. Before parsing results, check the model field in the response to determine the structure type.

Common Format (Most Models)

Grouped by task output type (type):

`type`	`results[i]` Structure	Typical Use Cases
`image`	`{url}`	Image generation, editing, enhancement
`video`	`{url}`	Video generation, lip-sync, video editing
`audio` (TTS / Music)	`{url}`	Text-to-speech, music generation
`llm`	Full OpenAI `ChatCompletion`: `{id, object:"chat.completion", created, model, choices[].message, usage}`	LLM generation (llm_router / llm_async)

All url links are valid for 24 hours. Please save them promptly.

Special Formats (By `model`)

The results[i] structure for the following models does not follow the common format above. Callers must handle them separately based on model.

Profile Creation (No Media URL Returned)

`model`	`type`	`results[i]` Structure	Notes
`kling-video-create-voice`	`video`	`{voice_id}`	Creates a reusable voice profile ID for subsequent Kling lip-sync / synthesis tasks
`sora-2-character`	`video`	`{character_id, name}`	Extracts a character profile from a reference video for character consistency in subsequent Sora 2 tasks
`phota-create-profile`	`image`	`{result_type, profile_id}`	Trains a person profile for use by other PHOTA models; `result_type` is always `profile`

Voice Cloning

`model`	`type`	`results[i]` Structure	Notes
`minimax-voice-clone`	`audio`	`{voice_id}`; with preview text, additionally returns `{url, content_type}`	MiniMax voice cloning: submit a reference audio to generate a reusable voice ID; if preview text is provided, the preview audio `url` is also returned

Speech Transcription (No Media URL Returned)

`model`	`type`	`results[i]` Structure	Notes
`scribe-v2`	`audio`	`{text, language_code, language_probability, words[]}`	Speech-to-text. `words[]` is a word-level timestamp array; each entry contains `text` / `start` / `end` / `type`

Video with Seed Value

`model`	`type`	`results[i]` Structure	Notes
`seedance-2.0-text-to-video`	`video`	`{url, seed}`	Additionally returns the generation seed for reproducibility
`seedance-2.0-fast-text-to-video`	`video`	`{url, seed}`	Same as above
`seedance-2.0-image-to-video`	`video`	`{url, seed}`	Same as above
`seedance-2.0-fast-image-to-video`	`video`	`{url, seed}`	Same as above
`seedance-2.0-reference-to-video`	`video`	`{url, seed}`	Same as above
`seedance-2.0-fast-reference-to-video`	`video`	`{url, seed}`	Same as above

The seed field is always present: it is the corresponding integer when the generation process returns a seed; if no seed is returned for this generation, it is null. Handle it as “field always present, value may be null”.

Reference Video Fast Variant Degradation Notice (`degraded_reason`)

`model`	`type`	`results[i]` Structure	Notes
`seedance-2.0-fast-reference-to-video`	`video`	`{url, degraded_reason?}`	When the requested media combination is “image + audio” or “video + audio”, the fast variant has no corresponding model, so the system automatically falls back to the standard reference-video model and injects explanatory text into `results[0].degraded_reason`. Other media combinations do not include this field.

PBR Material (Single Task Returns Multiple Semantically Labeled Results)

`model`	`type`	`results[i]` Structure	Notes
`patina-pbr-maps`	`image`	`{url, content_type, result_type: "pbr_map", map_type}`	PBR map generation. `map_type` identifies the map type (e.g. `albedo` / `normal` / `roughness`, etc.)
`patina-material`	`image`	Mixed: `{url, content_type, result_type: "texture"}` and `{url, content_type, result_type: "pbr_map", map_type}`	Outputs both tiling textures and multiple PBR maps; distinguish by `result_type`
`patina-material-extract`	`image`	Same as `patina-material`	Extracts textures from an existing image to generate a PBR map set

Music Generation with Lyrics Text

`model`	`type`	`results[i]` Structure	Notes
`lyria-3`	`audio`	`{url}`, some candidates add `{lyrics}`	30-second music clip; `lyrics` is the generated lyrics / section structure text, returned only by some candidates and omitted when absent
`lyria-3-pro`	`audio`	`{url}`, some candidates add `{lyrics}`	Full song (up to ~3 minutes); same as above, `lyrics` may be omitted depending on the candidate

Document Conversion (Result Is a ZIP Archive URL, Not a Direct Media Link)

`model`	`type`	`results[i]` Structure	Notes
`doc2x-v3`	`document`	`{url}`	PDF conversion result. `url` points to a downloadable ZIP archive containing the converted document files (md / tex / docx) and image assets; unlike the direct media URLs of image/video, this URL must be extracted before use

Parsing Recommendations

Read model first, then parse results: Different models under the same type may have completely different structures
Mind the expiration for URL results: All url links are valid for 24 hours; your application should download and store them immediately upon receipt
Profile-type tasks return voice_id / character_id / profile_id as long-lived resource identifiers that can be used directly in subsequent task parameters

Authorizations

Authorization

string

header

required

All endpoints require Bearer Token authentication

Add the following to your request headers:

Authorization: Bearer YOUR_API_KEY

Path Parameters

task_id

string

required

Task ID, returned by the task submission endpoint

Example:

"task-unified-1757165031-uyujaw3d"

Query Parameters

sync_upstream

boolean

default:false

Whether to proactively refresh the task status before returning. Only takes effect for tasks that are still in progress and have an associated remote task; otherwise, the current task status is returned directly.

Example:

true

Response

Query successful

string

Task ID

Example:

"task-unified-1757165031-uyujaw3d"

object

enum<string>

Specific task type

Available options:

video.generation.task,

image.generation.task,

audio.generation.task,

llm.generation.task

Example:

"video.generation.task"

type

enum<string>

Task output type

Available options:

video,

image,

audio,

llm

Example:

"video"

model

string

Actual model name used

Example:

"lipsync-2"

status

enum<string>

Task status

Options:

Value	Meaning
`pending`	Pending
`processing`	Processing
`completed`	Completed
`failed`	Failed

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

progress

integer

Task progress percentage

Required range: 0 <= x <= 100

Example:

0

created

integer

Task creation timestamp (Unix seconds)

Example:

1757165031

results

object[] | null

Task result list; only populated when status=completed.

Structure varies by task output type (type):

`type`	`results[i]` structure	Typical scenarios
`image`	`{url}`, some models include `content_type`; special tasks (e.g. PHOTA profile creation) return `{result_type, profile_id}`	Image generation, editing, enhancement
`video`	`{url}`, some models include `content_type` / `seed`; special subtasks (Kling voice creation / Sora 2 character profile) return `{voice_id}` or `{character_id, name}`	Video generation, lip-sync
`audio` (TTS / Music)	`{url}`	Text-to-speech, music generation
`audio` (STT / Transcription)	`{text, language_code, language_probability, words[]}` (no url)	Speech transcription (e.g. Scribe V2)
`audio` (Voice Clone)	`{voice_id}`; with preview text, additionally returns `{url, content_type}`	Voice cloning (e.g. MiniMax Voice Clone)
`llm`	Full OpenAI `ChatCompletion`: `{id, object:"chat.completion", created, model, choices[].message, usage}`	LLM generation (llm_gateway / llm_async)

General notes:

Result URLs are valid for 24 hours; please save them promptly
type=llm results are conversation responses and do not produce URLs
Some tasks produce non-media artifacts (voice profile / character profile creation, etc.); results contains id-type fields instead of url

Image result (type=image). Most image models only return url; some models (Patina family) also include content_type; PHOTA profile creation tasks return {result_type, profile_id} (non-image artifact)

Show child attributes

error

object | null

Error information; only populated when status=failed

Show child attributes

usage

object | null

Billing information

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Document Processing

Task Management

File Management

Query Task Status

`results` Field Format

Common Format (Most Models)

Special Formats (By `model`)

Profile Creation (No Media URL Returned)

Voice Cloning

Speech Transcription (No Media URL Returned)

Video with Seed Value

Reference Video Fast Variant Degradation Notice (`degraded_reason`)

PBR Material (Single Task Returns Multiple Semantically Labeled Results)

Music Generation with Lyrics Text

Document Conversion (Result Is a ZIP Archive URL, Not a Direct Media Link)

Parsing Recommendations

Authorizations

All endpoints require Bearer Token authentication

Path Parameters

Query Parameters

Response

​results Field Format

​Common Format (Most Models)

​Special Formats (By model)

​Profile Creation (No Media URL Returned)

​Voice Cloning

​Speech Transcription (No Media URL Returned)

​Video with Seed Value

​Reference Video Fast Variant Degradation Notice (degraded_reason)

​PBR Material (Single Task Returns Multiple Semantically Labeled Results)

​Music Generation with Lyrics Text

​Document Conversion (Result Is a ZIP Archive URL, Not a Direct Media Link)

​Parsing Recommendations

Authorizations

All endpoints require Bearer Token authentication

Path Parameters

Query Parameters

Response

`results` Field Format

Common Format (Most Models)

Special Formats (By `model`)

Profile Creation (No Media URL Returned)

Voice Cloning

Speech Transcription (No Media URL Returned)

Video with Seed Value

Reference Video Fast Variant Degradation Notice (`degraded_reason`)

PBR Material (Single Task Returns Multiple Semantically Labeled Results)

Music Generation with Lyrics Text

Document Conversion (Result Is a ZIP Archive URL, Not a Direct Media Link)

Parsing Recommendations