List Models

GET /api/models

Returns a list of all active AI models available for generation. Public endpoint, no authentication required. The default active list contains public generation models. Skill-specific billing entries are excluded; use the Skills interface for those workflows. Read is_default for the current image default. GPT Image 2.5 can be requested only after it appears in this active list.

Query Parameters

string

Filter by output type: image or video. Omit to get both.

string

default:"true"

Pass false to include inactive models as well, including retired or not-yet-enabled models. Their presence in this expanded list does not make them callable; use the default active list for generation.

Response

{ success: true, models: [...] }. Each model object contains:

string

The unique model identifier. Use this as modelId when generating.

boolean

Whether this model is the current platform default for its media type. Do not infer the default from ordering, the model name, or a documentation example.

string

Display name.

string

Model provider family (e.g. OpenAI, Google, ByteDance, Midjourney). Display only — not a request parameter.

number

A nominal fallback value. Do not use it as the price for every configuration. For GPT Image 2.5 and GPT Image 2, read extra_config.pricing[resolution][quality]. Use extra_config.pricingPerSec × duration, extra_config.pricingPerCall[tier][duration] for Veo 3.1, or the reference-video rules below. The authoritative charge is creditsUsed in the generate response.

string[]

Aspect ratios accepted by aspectRatio. Seedance additionally accepts "adaptive".

number

For image models, the maximum number of reference images accepted (0 means none). For video models, this is the first/last-frame slot limit. Seedance content-reference mode uses extra_config.maxContentReferenceImages instead.

string

"image" or "video".

object

Estimated generation time for this model’s default tier/resolution, in seconds: { p50, p90 }. Calibrated from production data — use it to set user expectations, not as a hard deadline. Actual time still varies by resolution, tier, and duration.

object

Stable, forward-compatible capability contract. capabilities.video is always an object: check capabilities.video.valid to distinguish video models (true) from image models (false). When valid, it describes output duration options, reference-video continuation limits, billing mode, and whether a first frame is required. Do not test if (capabilities.video) because the object is also present on image models. New integrations should read this contract instead of reconstructing it from extra_config.

object

Model-specific configuration, kept for backward compatibility. New integrations should prefer capabilities.video for video-capability shape (see above); the pricing keys below are still only available here. Keys you may rely on:

Key	Used by	Description
`resolutions`	Image / video	Allowed values for `resolution` (`"1K"` / `"2K"` / `"3K"` / `"4K"` for image, `"480p"` / `"720p"` / `"1080p"` / `"4k"` for video)
`qualities`	Image models with quality options	Accepted `quality` values; GPT Image 2.5 has `low`, `medium`, `high`, `xhigh`, `max`
`defaultQuality`	Image models with quality options	Used when `quality` is omitted or `auto`; GPT Image 2.5 is configured as `low`
`variants` / `defaultVariant`	GPT Image 2.5	Accepted `modelVariant` values (`sunburst`, `flare`) and the configured default (`sunburst`)
`defaultResolution`	Image / video	Resolution used when the request omits `resolution`
`pricing`	Image models with variable prices	Credits by resolution then quality, for example `pricing["2K"]["low"]`; some models expose a number per resolution
`tierResolutions`	Seedance 2.0	Resolutions actually available in each tier, keyed by tier. Takes precedence over the top-level `resolutions`
`tiers`	Seedance 2.0 / Veo 3.1	Available tiers, selected via `tier` (Seedance 2.0: `mini` / `fast` / `pro`; Veo 3.1: `fast` / `pro`)
`durations`	Video models	Allowed values for `duration` (seconds)
`pricingPerSec`	Seedance 2.5 / Seedance 2.0 / Grok Video 1.5 / Agnes Video 2.5 Flash	Per-second direct-generation rate, keyed by resolution — or by tier then resolution on models that expose tiers
`pricingPerCall`	Veo 3.1	Credits per generation, looked up by tier then `duration`. Mutually exclusive with `pricingPerSec`; when present it takes precedence
`pricingPerSecWithVideo`	Seedance 2.5 / Seedance 2.0	Per-second rate with `referenceVideo`, keyed by resolution — or by tier then resolution
`minBillableTable`	Seedance 2.5 / Seedance 2.0	Minimum billable seconds keyed by output `duration`; bill `max(reference + output, minimum)`
`maxContentReferenceImages`	Seedance 2.5 / Seedance 2.0	Maximum images accepted when `referenceMode` is `content`; separate from the first/last-frame slots in `max_reference_images`

The pricing-related keys above are part of the contract. Other keys may appear and are informational.

Example

curl https://www.meigen.ai/api/models

{
  "success": true,
  "models": [
    {
      "id": "gpt-image-2.5",
      "name": "GPT Image 2.5",
      "provider": "OpenAI",
      "is_default": false,
      "credits_per_generation": 6,
      "supported_ratios": ["1:1", "3:2", "2:3", "16:9", "9:16", "4:3", "3:4", "5:4", "4:5", "21:9", "9:21", "3:1", "1:3"],
      "max_reference_images": 16,
      "media_type": "image",
      "extra_config": {
        "resolutions": ["1K", "2K", "4K"],
        "defaultResolution": "2K",
        "qualities": ["low", "medium", "high", "xhigh", "max"],
        "defaultQuality": "low",
        "variants": ["sunburst", "flare"],
        "defaultVariant": "sunburst",
        "pricing": {
          "1K": { "low": 4, "medium": 6, "high": 12, "xhigh": 18, "max": 28 },
          "2K": { "low": 6, "medium": 9, "high": 22, "xhigh": 30, "max": 48 },
          "4K": { "low": 12, "medium": 16, "high": 36, "xhigh": 50, "max": 88 }
        }
      },
      "capabilities": {
        "video": {
          "outputDuration": null,
          "referenceVideo": { "enabled": false, "minSeconds": 0, "maxSeconds": 0, "maxUploadBytes": 0 },
          "billing": null,
          "requiresFirstFrame": false,
          "valid": false
        }
      }
    },
    {
      "id": "seedance-2-5",
      "name": "Seedance 2.5",
      "provider": "ByteDance",
      "credits_per_generation": 72,
      "supported_ratios": ["adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9"],
      "max_reference_images": 2,
      "media_type": "video",
      "extra_config": {
        "resolutions": ["480p", "720p"],
        "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30],
        "maxContentReferenceImages": 30,
        "pricingPerSec": { "480p": 18, "720p": 39 },
        "pricingPerSecWithVideo": { "480p": 11, "720p": 24 },
        "minBillableTable": { "4": 7, "5": 9, "6": 10, "7": 12, "8": 14, "9": 15, "10": 17, "11": 19, "12": 20, "13": 22, "14": 24, "15": 25, "16": 27, "17": 29, "18": 30, "19": 32, "20": 34, "21": 35, "22": 37, "23": 39, "24": 40, "25": 42, "26": 44, "27": 45, "28": 47, "29": 49, "30": 50 }
      },
      "estimatedTiming": { "p50": 118, "p90": 165.2 },
      "capabilities": {
        "video": {
          "outputDuration": { "kind": "range", "min": 4, "max": 30, "step": 1, "default": 4 },
          "referenceVideo": {
            "enabled": true,
            "minSeconds": 2,
            "maxSeconds": 30,
            "maxUploadBytes": 209715200,
            "resolutions": ["480p", "720p"]
          },
          "billing": { "mode": "per_second", "requestDefaultSeconds": 4, "referenceSeconds": "reference_plus_output_with_minimum_table" },
          "requiresFirstFrame": false,
          "valid": true
        }
      }
    }
  ]
}

Example shows two representative model configurations with a partial extra_config for brevity. It does not assert that either model is currently enabled or the default. Timing values are an illustrative production snapshot and may change as estimates are recalibrated. The live endpoint returns all active models with their current full configuration. Responses are cached for 1 hour (plus stale-while-revalidate), so newly added or retired models can take up to an hour to appear.

Overview

Endpoints

Query Parameters

Response

Example

​Query Parameters

​Response

​Example

Query Parameters

Response

Example