API reference / Models

Get a model

llms-full.txt

GEThttps://api.minicut.ai/v1/models/{model_id}

One model, with its input schema

Path

model_idstringrequired

Response 200

idstring

namestring

kindstring

statusstring

on_salecoming_soon

descriptionstring or null

currencystring

The currency of every amount on this object and the items inside it. Always USD

pricesarray of objects

inputsarray of objects

cardobject

card.inputsobject

card.inputs.start_frameboolean

card.inputs.end_frameboolean

card.inputs.sourceboolean

Takes one whole clip or sound to work on (lip sync, upscale, clip repair, sound split)

card.inputs.image_refsinteger or null

Most reference pictures a call takes; null when the model takes them and publishes no limit

card.inputs.video_refsinteger

card.inputs.audio_refsinteger

card.inputs.billed_byarray of strings

The inputs whose length the price follows, first one billed

card.modesarray of strings

text, firstFrame, firstLast, reference, extend, mask

card.settingsobject

card.settings.controlsarray of objects

card.settings.secondsobject or null

card.settings.ratiosarray of strings or null

Every shape the model makes, as the website panel offers them

card.settings.ratio_defaultstring or null

The shape priced and sent when none is asked

card.settings.soundobject or null

The model makes sound that can be switched off, and whether it is on by default

card.settings.resolutionsarray of objects or null

openapiobject or null

curl "https://api.minicut.ai/v1/models/seedance-2.5" \
  -H "Authorization: Key $MINIAPI_KEY"

Response 200

{
  "id": "seedance-2.5",
  "name": "Seedance 2.5",
  "kind": "video",
  "status": "on_sale",
  "currency": "USD",
  "prices": [
    {
      "tier": "720p",
      "unit": "second",
      "price": "0.350000"
    }
  ],
  "inputs": [
    "prompt",
    "resolution",
    "duration"
  ]
}

401missing_api_key No Authorization header

401invalid_api_key Wrong, unknown or revoked key

404model_not_found No model has that id

429rate_limited Too many requests; wait for Retry-After

500internal_error Our side; try again