Skip to main content
Use this API to dynamically retrieve available AI models and their configurations for your application.

​
Get AI Model List

GET https://openapi.akool.com/api/open/v4/aigModel/list
Request Headers
ParameterValueDescription
x-api-keyAPI KeyYour API Key used for request authorization. If both Authorization and x-api-key have values, Authorization will be used first and x-api-key will be discarded.
AuthorizationBearer {token}Your API Key used for request authorization.Get Token
Query Parameters
ParameterTypeRequiredDescription
typesArraytrueArray of model types to retrieve. At least one type is required
Supported Model Types
Type ValueDescription
1501Image to Video - Animate static images into videos
1502Text to Video - Generate videos from text descriptions
Response Attributes
ParameterTypeDescription
codeIntegerInterface returns business status code (1000:success)
msgStringInterface returns status information
dataArrayArray of model configuration objects
Model Configuration Object
ParameterTypeDescription
sortIntegerSort order (higher values appear first)
groupStringModel group/category
providerStringModel provider (akool, seedance, minimax, vidu, etc.)
typeIntegerModel type (matches request types)
labelStringDisplay name of the model
valueStringModel identifier to use in API calls
descriptionStringModel description
resolutionListArraySupported resolutions with pricing details
isProBooleanWhether this is a premium model
generate_audioBoolean/nullWhether the model supports audio generation
durationListArraySupported video durations in seconds
requiresPayBooleanWhether a paid account is required
supportedLastFrameBooleanWhether the model supports last frame specification
supportedExtendPromptBooleanWhether the model supports prompt extension
maxImageCountIntegerMaximum number of reference images supported
maxCountIntegerMaximum number of items per batch
resolutionList Item Attributes
ParameterTypeDescription
labelStringDisplay label for the resolution
valueStringResolution value (e.g., “720p”, “1080p”)
widthIntegerVideo width in pixels
heightIntegerVideo height in pixels

​
Examples

​
Example 1: Get Image to Video Models

Request 
curl --location 'https://openapi.akool.com/api/open/v4/aigModel/list?types[]=1501' \
--header 'x-api-key: {{API Key}}'
Response 
{
  "code": 1000,
  "msg": "OK",
  "data": [
    {
      "sort": 100,
      "group": "akool",
      "provider": "akool",
      "type": 1501,
      "label": "Akool Image2Video Fast V1",
      "value": "AkoolImage2VideoFastV1",
      "description": "Fast image to video generation with Akool's AI",
      "resolutionList": [
        {
          "label": "720p",
          "value": "720p",
          "width": 1280,
          "height": 720,
          "unit_credit": 5
        },
        {
          "label": "1080p",
          "value": "1080p",
          "width": 1920,
          "height": 1080,
          "unit_credit": 10
        },
        {
          "label": "4k",
          "value": "4k",
          "width": 3840,
          "height": 2160,
          "unit_credit": 20
        }
      ],
      "isPro": false,
      "generate_audio": null,
      "durationList": [5, 10],
      "requiresPay": false,
      "supportedLastFrame": false,
      "supportedExtendPrompt": false,
      "maxImageCount": 1,
      "maxCount": 10
    },
    {
      "sort": 95,
      "group": "seedance",
      "provider": "seedance",
      "type": 1501,
      "label": "Seedance Lite Image2Video",
      "value": "seedance-1-0-lite-i2v-250428",
      "description": "Seedance Lite model for image to video generation",
      "resolutionList": [
        {
          "label": "480p",
          "value": "480p",
          "width": 854,
          "height": 480,
          "unit_credit": 3
        },
        {
          "label": "720p",
          "value": "720p",
          "width": 1280,
          "height": 720,
          "unit_credit": 5
        },
        {
          "label": "1080p",
          "value": "1080p",
          "width": 1920,
          "height": 1080,
          "unit_credit": 10
        }
      ],
      "isPro": false,
      "generate_audio": null,
      "durationList": [5, 10],
      "requiresPay": false,
      "supportedLastFrame": true,
      "supportedExtendPrompt": false,
      "maxImageCount": 1,
      "maxCount": 10
    }
  ]
}

​
Response Data Structure

{
  code: 1000,
  msg: "OK",
  data: [
    {
      // Model metadata
      sort: 100,              // Higher = appears first
      group: "akool",         // Model group
      provider: "akool",      // Provider name
      type: 1501,             // Model type
      
      // Display information
      label: "Model Name",
      value: "model_identifier",
      description: "Description",
      
      // Pricing & limits
      requiresPay: false,
      isPro: false,
      maxCount: 10,
      
      // Supported parameters
      resolutionList: [...],
      durationList: [5, 10],
      
      // Features
      supportedLastFrame: false,
      supportedExtendPrompt: false,
      maxImageCount: 1,
    }
  ]
}