# Elige el modelo

> El catálogo completo de modelos de IA de CutPro: texto, embeddings, imagen, video, voz, música, sonido, avatares, 3D y herramientas, con precio y lo que acepta cada uno.

Todo modelo que corre CutPro está en `GET /models`: modelos de chat (Claude, GPT, Gemini, Grok, DeepSeek, Qwen, Llama, Mistral y otros), embeddings, imagen, video, voz, música, efectos de sonido, avatares que hablan, 3D y herramientas de imagen y de video. `GET /models/featured` trae solo los más recomendados de cada tipo, para cuando la persona no elige.

```bash
curl "https://api.cut.pro/api/v1/models?kind=music" \
  -H "X-Api-Key: $CUTPRO_API_KEY"
```

```json title="200 OK (ejemplo resumido)"
{
  "models": [
    {
      "id": "suno/music-generate",
      "name": "Suno Generate Music",
      "maker": "suno",
      "kind": "music",
      "endpoint": "generations",
      "featured": false,
      "pricing": [{ "unit": "run", "credits": 13.73, "mode": null, "resolution": null, "silent_credits": null }],
      "priced_by_request": true,
      "parameters": {
        "properties": {
          "custom_mode": { "type": "boolean" },
          "instrumental": { "type": "boolean" },
          "model": { "type": "string" },
          "prompt": { "type": "string" },
          "style": { "type": "string" },
          "lyrics": { "type": "string" }
        },
        "required": ["custom_mode", "instrumental", "model"]
      }
    }
  ]
}
```

Filtra con `kind`, `endpoint`, `q` (parte del id o del nombre) o `id`.

| Campo | Para qué sirve |
|---|---|
| `kind` | Lo que hace el modelo: `text`, `embedding`, `image`, `video`, `speech` (voz), `music`, `audio` (efectos de sonido, música y edición de audio), `avatar` (una persona que habla a partir de una foto y un sonido), `model3d`, `tool` (edita una imagen: sube la resolución, quita el fondo, borra) o `videoedit` (edita un video). |
| `endpoint` | Dónde corre: `generations` ([Genera con IA](/es/generations)), `chat_completions` o `embeddings` ([Chat y embeddings](/es/text)). |
| `pricing` | Créditos por unidad: `image`, `second`, `minute`, `1k_characters`, `run` (por ejecución), `megapixel` (del resultado; en un video, de todos los cuadros) o por millón de tokens (`1m_input_tokens`, `1m_output_tokens`, `1m_tokens`; en un video, los tokens son los píxeles de cada cuadro divididos por 1.024). |
| `priced_by_request` | `true` cuando el total depende de los campos del pedido (duración, calidad): léelo siempre de `POST /generations/quote`. |
| `parameters` | Los campos propios del modelo (calidad, pasos, guidance, prompt negativo, estilo), que van en `options` de `POST /generations`. `prompt`, `seconds`, `aspect_ratio`, `voice`, `seed`, imágenes, sonidos y video se colocan en los nombres correctos por ti. Vale también para los modelos de imagen, video y voz curados. |
| `supported_parameters` | En un modelo de texto, los campos que acepta además de `messages`, como `reasoning_effort`, `reasoning`, `tools` y `response_format`. |
| `context_length`, `max_output_tokens` | Para modelos de texto. |
| `modes`, `resolutions`, `seconds`, `voices` y los demás | Para los modelos de imagen, video y voz curados por CutPro. |

> Los precios cambian en cualquier momento. Léelos de aquí o, para el total exacto de una generación, de `POST /generations/quote`. Nunca fijes un precio en el código.