Retrieve the list of videos currently running via the API along with the available account capacity

October 15, 2024 (March 17, 2025)

Table of contents

  1. Request Headers
  2. Responses
  3. Model
  4. Examples
  5. Try It

This endpoint retrieves the list of images and videos currently running via the API along with the available account capacity.

If you want to get all videos currently being executed including you manually initiated from hailuoai.com website use GET /videos.

If you want to get all images currently being executed including you manually initiated from hailuoai.com website use GET /images.

Please refer to code provided in article Fun with MiniMax API to see how this endpoint can be used in conjunction with POST /files and POST videos/create.

NOTE: The available capacity (array available) includes only videos, the API does not include currently executing image generations in that capacity.

https://api.useapi.net/v1/minimax/scheduler/available

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
Responses

  • 200 OK

    {
    "executing": [
        {
            "videoId": "user:user_id-minimax:account-video:id1",
            "started": "2024-09-25T01:55:16.128Z",
            "elapsed": "03:57",
            "replyUrl": "<optional callback URL>",
            "replyRef": "<optional reference>"
        },
        {
            "videoId": "user:user_id-minimax:account-image:inN",
            "started": "2024-09-25T01:58:18.555Z",
            "elapsed": "00:35",
            "replyUrl": "<optional callback URL>",
            "replyRef": "<optional reference>"
        }
    ],
    "available": [
        {
            "account": "<account_1>",
            "maxJobs": 5,
            "executing": 0,
            "available": 5
        },
        {
            "account": "<account_2>",
            "maxJobs": 5,
            "executing": 3,
            "available": 2
        },
        {
            "account": "<account_N>",
            "maxJobs": 3,
            "executing": 2,
            "available": 1
        }
    ]
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}
Model 
{ // TypeScript, all fields are optional
    executing: {
        videoId: string
        imageId: string
        started: string 
        elapsed: string 
        replyUrl: string
        replyRef: string
    }[]
    available: {
        account: string
        maxJobs: number
        executing: number
        available: number
    }[]
    error: string
    code: number
}
Examples 
  • curl "https://api.useapi.net/v1/minimax/scheduler/available" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 

  • const token = "API token";
const apiUrl = `https://api.useapi.net/v1/minimax/scheduler/available`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
apiUrl = f"https://api.useapi.net/v1/minimax/scheduler/available"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It