Get Model

Retrieve detailed information about a specific model, including all its versions.

GET /v1/models/{modelId}

cURL

curl -X GET https://api.muvi.video/v1/models/model_abc123 \
  -H "x-api-key: YOUR_API_KEY"

200

{
  "id": "model_abc123",
  "providerId": "google",
  "providerName": "Google",
  "name": "Veo 3.1 Fast",
  "description": "High-speed video generation model",
  "category": "video",
  "currentVersion": "v1.0",
  "versions": [
    {
      "versionId": "v1.0",
      "status": "active",
      "inputSchema": {
        "type": "object",
        "properties": {
          "prompt": { "type": "string" },
          "duration": { "type": "number" }
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "videoUrl": { "type": "string" }
        }
      },
      "pricing": {
        "baseCredits": 50,
        "unit": "per_generation"
      },
      "rateLimits": {
        "requestsPerMinute": 10,
        "requestsPerDay": 500
      }
    }
  ]
}

Authentication

Requires an API key with list_models scope.

x-api-key · string · required

Your API key with list_models scope.

Path Parameters

modelId · string · required

The unique identifier of the model.

Response

id · string

Unique model identifier.

providerId · string

ID of the provider.

providerName · string

Display name of the provider.

name · string

Display name of the model.

description · string

Brief description of the model.

category · string

Model category.

currentVersion · string

Currently active version identifier.

versions · array

All versions of this model.

Show Version Object

versionId · string

Unique version identifier.

status · string

Version status. One of: active, deprecated, disabled, deleted.

inputSchema · object

JSON Schema for the model’s input parameters.

outputSchema · object

JSON Schema for the model’s output format.

pricing · object

Pricing configuration for this version.

rateLimits · object

Rate limiting configuration for this version.

Version Status

Status	Description
active	Currently available and recommended for use.
deprecated	Still functional but will be removed in a future update.
disabled	Temporarily unavailable.
deleted	Permanently removed and no longer accessible.

cURL

curl -X GET https://api.muvi.video/v1/models/model_abc123 \
  -H "x-api-key: YOUR_API_KEY"

200

{
  "id": "model_abc123",
  "providerId": "google",
  "providerName": "Google",
  "name": "Veo 3.1 Fast",
  "description": "High-speed video generation model",
  "category": "video",
  "currentVersion": "v1.0",
  "versions": [
    {
      "versionId": "v1.0",
      "status": "active",
      "inputSchema": {
        "type": "object",
        "properties": {
          "prompt": { "type": "string" },
          "duration": { "type": "number" }
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "videoUrl": { "type": "string" }
        }
      },
      "pricing": {
        "baseCredits": 50,
        "unit": "per_generation"
      },
      "rateLimits": {
        "requestsPerMinute": 10,
        "requestsPerDay": 500
      }
    }
  ]
}