Models

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);

from getimg import GetimgAI

client = GetimgAI()

models = client.models.list()
print(models)

curl https://api.getimg.ai/v2/models \
  -H "Authorization: Bearer $GETIMG_API_KEY"

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);

from getimg import GetimgAI

client = GetimgAI()

video_models = client.models.list(type="video")
print(video_models)

curl "https://api.getimg.ai/v2/models?type=video" \
  -H "Authorization: Bearer $GETIMG_API_KEY"

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.

Getting started

Generation

Concepts

What this endpoint returns

List models

Filter by type

Image vs video models

How to choose a model

Where to check current availability

​What this endpoint returns

​List models

​Filter by type

​Image vs video models

​How to choose a model

​Where to check current availability

​Related pages

What this endpoint returns

List models

Filter by type

Image vs video models

How to choose a model

Where to check current availability

Related pages