Skip to main content
Use GET /v2/models to list the models available to your project and choose the right one without guesswork. 
GET https://api.getimg.ai/v2/models

​
What this endpoint returns

The models endpoint returns the image and video models available to your authenticated project. Use it when you need to:
  • discover current model IDs
  • separate image models from video models
  • avoid hardcoding outdated model lists in your integration

​
List models

import GetimgAI from "getimg-ai";

const client = new GetimgAI();

const models = await client.models.list();
console.log(models);

​
Filter by type

Use the optional type query parameter when you only want one category. 
import GetimgAI from "getimg-ai";

const client = new GetimgAI();

const videoModels = await client.models.list({ type: "video" });
console.log(videoModels);
Use type=image for image models and type=video for video models.

​
Image vs video models

Choose the model type based on the generation type:
  • Image models are for POST /v2/images/generations
  • Video models are for POST /v2/videos/generations
The available parameters and supported options can differ by model. Supported aspect ratios, resolutions, durations, sound, and image roles all depend on the model you choose.

​
How to choose a model

Start with these checks:
  • generation type: image or video
  • input shape: prompt only, reference image, first frame, or last frame
  • output needs: aspect ratio, resolution, duration, and sound
If your integration depends on a specific capability, fetch the current model list and validate the model before you submit a generation. That keeps your production flow stable as model availability changes.

​
Where to check current availability

Use one of these sources:
  • GET /v2/models in your integration
  • the Models page in the dashboard
Avoid documenting or hardcoding a fixed model list in user-facing content. Model availability can change.