---
title: "Get a model"
method: GET
path: "/models/{provider}/{model}"
tags: ["Models"]
---

# Get a model

`GET /models/{provider}/{model}`

## Request

- Base URL: `https://www.rainbrand.com/api/v1`
- URL: `https://www.rainbrand.com/api/v1/models/{provider}/{model}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://www.rainbrand.com/api/auth/oauth2/authorize`
    - Token URL: `https://www.rainbrand.com/api/auth/oauth2/token`

Read the input schema for a chosen model.

## Path parameters

- `provider` string, required: First segment of the model ID, before the first slash.
- `model` string, required: Remaining model ID after the first slash, URL-encoded as one path segment, including any additional slashes.

## Response `200`

OK

- object
  - `data` object, required
    - `id` string, required: Exact model ID. Use this value when fetching model details or starting a generation.
    - `provider` string, required: Provider that offers the model.
    - `name` string, required: Display name of the model.
    - `type` 'image' | 'video' | 'audio' | 'svg', required: Type of file the model generates.
    - `capabilities` string[], required: Machine-readable tags identifying the model’s supported operations, such as `text-to-image` or `image-to-video`.
    - `description` string, required: Description of the model and its capabilities.
    - `inputSchema` object, required: JSON Schema for the input sent to POST /generations. Where a reference field accepts HTTPS URLs, Rainbrand handles any conversion required by the provider.

## Other responses

- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429
- `503`: 503

---

[API](https://skmtc.dev/rainbrand/apis/rainbrand-api.md) - [All operations](https://skmtc.dev/rainbrand/apis/rainbrand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rainbrand/apis/rainbrand-api/revisions/012b8e9da4df?raw)