# List Models

`GET /v1/models`

List every model available to your account.

Returns the live catalogue: ids, pricing, limits, and, for our own fine-tunes, the trigger word the gateway injects for you.

Base URL: `https://api.spicyapi.com`

## Authorizations

- `Authorization` (string, header, required): Bearer authentication header of the form `Bearer <token>`, where `<token>` is your SpicyAPI key (`sk-spicy-…`). Create one in the dashboard under API Keys.

## Request

```bash
curl --request GET \
  --url https://api.spicyapi.com/v1/models \
  --header 'Authorization: Bearer $SPICYAPI_KEY'
```

## Response: 200 application/json

Successful Response

The models your key can call.

- `data` (Model · object[], required): Every model available to you.
  - `id` (string, required): The model id you pass as `model`.
  - `kind` (string, required): One of `image`, `image-edit`, `video`, `chat`.
  - `label` (string, required): Human-readable name.
  - `description` (string, required): What the model is good for.
  - `featured` (boolean, required): True for our own fine-tunes.
  - `requires_image` (boolean, required): True when the model needs an `image_url` input.
  - `accepts_image` (boolean, required): True when `image_url` is allowed. False on pure text-to-video models, which reject one.
  - `pricing` (object, required): Unit and USD rate. Video models price per second, by resolution.
  - `lora_trigger` (string | null, optional): Trigger word for a fine-tune. Injected automatically, you do not need to include it.
  - `limits` (object, optional): Sizes, resolutions, max duration, max outputs.
  - `examples` (string[], optional): Example output URLs for this model.

```json
{
  "data": [
    {
      "id": "spicy-pov-missionary-1",
      "kind": "video",
      "label": "Spicy POV Missionary",
      "featured": true,
      "requires_image": true,
      "accepts_image": true,
      "pricing": { "unit": "second", "usd_by_resolution": { "720P": 0.175, "1080P": 0.29 } },
      "lora_trigger": "sg_povmis1",
      "limits": { "resolutions": ["720P", "1080P"], "maxDuration": 15 }
    }
  ]
}
```