> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pixelbyte.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Model

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

## Authentication

Requires an API key with `list_models` scope.

<ParamField header="x-api-key" type="string" required>
  Your API key with `list_models` scope.
</ParamField>

## Path Parameters

<ParamField path="modelId" type="string" required>
  The unique identifier of the model.
</ParamField>

## Response

<ResponseField name="id" type="string">Unique model identifier.</ResponseField>
<ResponseField name="providerId" type="string">ID of the provider.</ResponseField>
<ResponseField name="providerName" type="string">Display name of the provider.</ResponseField>
<ResponseField name="name" type="string">Display name of the model.</ResponseField>
<ResponseField name="description" type="string">Brief description of the model.</ResponseField>
<ResponseField name="category" type="string">Model category.</ResponseField>
<ResponseField name="currentVersion" type="string">Currently active version identifier.</ResponseField>

<ResponseField name="versions" type="array">
  All versions of this model.

  <Expandable title="Version Object">
    <ResponseField name="versionId" type="string">Unique version identifier.</ResponseField>

    <ResponseField name="status" type="string">
      Version status. One of: `active`, `deprecated`, `disabled`, `deleted`.
    </ResponseField>

    <ResponseField name="inputSchema" type="object">JSON Schema for the model's input parameters.</ResponseField>
    <ResponseField name="outputSchema" type="object">JSON Schema for the model's output format.</ResponseField>
    <ResponseField name="pricing" type="object">Pricing configuration for this version.</ResponseField>
    <ResponseField name="rateLimits" type="object">Rate limiting configuration for this version.</ResponseField>
  </Expandable>
</ResponseField>

### 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.            |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.muvi.video/v1/models/model_abc123 \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  model_id = "model_abc123"
  response = requests.get(
      f"https://api.muvi.video/v1/models/{model_id}",
      headers={"x-api-key": "YOUR_API_KEY"}
  )

  model = response.json()
  print(f"{model['name']} - {len(model['versions'])} versions")
  ```

  ```javascript JavaScript theme={null}
  const modelId = "model_abc123";
  const response = await fetch(
    `https://api.muvi.video/v1/models/${modelId}`,
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  );

  const model = await response.json();
  console.log(`${model.name} - ${model.versions.length} versions`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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
        }
      }
    ]
  }
  ```
</ResponseExample>