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.

Web-only models are excluded even when active=false, except the explicit HeyGen gateway adapter. HeyGen Video 1 is available in the active API/MCP catalog. This exception does not enable native apps or disabled reference capabilities.

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 and reference-audio 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.capabilities.video.referenceVideo carries enabled, minSeconds and maxSeconds (per clip), plus maxCount and maxTotalSeconds for the whole array — Seedance 2.5 allows 10 clips totalling 30s, Seedance 2.0 allows 3 clips totalling 15s. capabilities.video.referenceAudio has the same shape plus formats (["wav", "mp3"]) and requiresVisualReference: when it is true (Seedance 2.0) the request must also carry at least one reference image or reference video, so audio-only generation is rejected. Current responses always include both objects. A response body cached before 2026-09 may still lack them, so treat a missing referenceVideo or referenceAudio as { "enabled": false } rather than as “unlimited”. The additive referenceAudio.canCombineWithVideo field defaults to true when absent. When false (HeyGen), separate reference audio and reference video cannot coexist; audio embedded in video is allowed. Audio seconds are never added to billing, but HeyGen audio/content images select the content-reference rate.

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 / Grok Video 1.5	Resolutions actually available in each tier, keyed by tier. Takes precedence over the top-level `resolutions`
`tiers`	Seedance 2.0 / Veo 3.1 / Grok Video 1.5	Available `tier` values: Seedance 2.0 `mini` / `fast` / `pro`; Veo 3.1 `fast` / `pro`; Grok Video 1.5 `lite` / `standard`
`defaultTier`	Video models with tiers	Tier used when `tier` is omitted; Grok Video 1.5 defaults to `lite`
`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 used when any reference video is present, keyed by resolution — or by tier then resolution. Reference audio alone does not switch to this rate; an audio-only request bills at `pricingPerSec`
`minBillableTable`	Seedance 2.5 / Seedance 2.0	Minimum billable seconds keyed by output `duration`; bill `max(sum of reference video durations + output, minimum)`. Reference audio durations are never included
`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`

Grok Video 1.5 uses a nested matrix: pricingPerSec[tier][resolution]. Current rates at 480p / 720p / 1080p are Lite 4 / 6 / 28 and Standard 16 / 28 / 50 credits/sec. Defaults are lite, 480p, 4 seconds (16 credits). Fetch current values rather than retaining the old resolution-only pricing shape.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, "maxCount": 0, "maxTotalSeconds": 0, "maxUploadBytes": 0 },
          "referenceAudio": { "enabled": false, "minSeconds": 0, "maxSeconds": 0, "maxCount": 0, "maxTotalSeconds": 0, "maxUploadBytes": 0, "formats": [], "requiresVisualReference": false },
          "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", "1080p"],
        "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, "1080p": 90 },
        "pricingPerSecWithVideo": { "480p": 11, "720p": 24, "1080p": 54 },
        "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,
            "maxCount": 10,
            "maxTotalSeconds": 30,
            "maxUploadBytes": 209715200,
            "resolutions": ["480p", "720p", "1080p"]
          },
          "referenceAudio": {
            "enabled": true,
            "minSeconds": 2,
            "maxSeconds": 30,
            "maxCount": 10,
            "maxTotalSeconds": 30,
            "maxUploadBytes": 15728640,
            "formats": ["wav", "mp3"],
            "requiresVisualReference": false
          },
          "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

Skills API

Query Parameters

Response

Example

​Query Parameters

​Response

​Example

Query Parameters

Response

Example