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