---
title: "List models with full detail"
method: GET
path: "/api/v1/models"
---

# List models with full detail

`GET /api/v1/models`

## Request

- Base URL: `https://genmagic.co`
- URL: `https://genmagic.co/api/v1/models`
- Auth: one of:
  - none
  - HTTP bearer

OpenAI-compatible model list enriched with capabilities, pricing, and benchmarks from the same live catalog the studio uses, newest first (by created, a Unix timestamp in seconds). Text models also carry supported_parameters, capabilities.reasoning_efforts and reasoning_mandatory, and cache, reasoning and long-context (tiers) prices where the model publishes them; audio models carry audio_kind (speech or music), the endpoint that runs them. A pure lookup: spends no credits, and works without a key. This is a lookup and spends no credits.

## Query parameters

- `category` 'text' | 'image' | 'audio' | 'video': Filter by output category.
- `capability` 'reasoning' | 'vision' | 'tools' | 'structured': Filter by capability.
- `search` string: Substring of a model id or name.

## Response `200`

Success.

## Other responses

- `401`: authentication_error: invalid API key (a request without a key is answered anonymously).
- `429`: rate_limit_error: over 300 requests/minute for this key.

---

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