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

# Get Studio Models

> List Studio image/video models with normalized capabilities, params, and credit notes.

Returns partner-ready model metadata for Studio generation.

## Query Parameters

<ParamField query="mode" type="string">
  Optional filter: `image`, `video`, or `all`. Omit to return both (`all`).
</ParamField>

## Response

Successful requests return `200` with:

* `mode` - `all`, `image`, or `video`
* `total` - number of returned models
* `models` - normalized model list

### Model Object

| Field | Type | Description |
| - | - | - |
| `id` | `string` | Model ID used in generation requests |
| `mode` | `image \| video` | Model category |
| `name` | `string` | Display name |
| `provider` | `string` | Provider label |
| `description` | `string` | Short model description |
| `credits.default_cost` | `number` | Default credit estimate |
| `credits.notes` | `string` | Credit calculation notes |
| `capabilities` | `object` | Supported input/output modes |
| `inputs` | `object` | Required and optional fields, plus conditional rules (for example `one_of:motion,prompt` or `one_of:audio_url,speech_text`) when applicable |
| `params` | `object` | Normalized params and options |
| `raw_available_params` | `object \| null` | Raw internal options for advanced mapping |

`inputs.optional` only lists `speech_text`, `voice_id`, and `audio_url` when
the selected model supports explicit speech, lipsync input, or Seedance 2.0
reference audio. Prompt-driven models such as `openai/sora-2` and
`google/veo-3` are prompt-only: include spoken dialogue inside `prompt` and do
not send separate speech fields.

<ResponseExample>
  ```json Response theme={null}
  {
    "ok": true,
    "code": 200,
    "message": "Studio models retrieved",
    "data": {
      "mode": "image",
      "total": 1,
      "models": [
        {
          "id": "google/nano-banana",
          "mode": "image",
          "name": "Nano Banana",
          "provider": "Google",
          "credits": {
            "default_cost": 1,
            "notes": "Credits match in-app AI Studio cost calculation."
          }
        }
      ]
    }
  }
  ```
</ResponseExample>

## Error Responses

* `401` - authentication failed (missing/invalid/revoked token)
* `402 subscription_required` - active Creator/Professional/Business plan required
* `403 tier_not_allowed` - Scheduler tier cannot use Partner API
* `422 invalid_query` - unsupported `mode`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.