# Escolha o modelo

> O catálogo completo de modelos de IA da Cut.Pro: texto, embeddings, imagem, vídeo, voz, música, som, avatar, 3D e ferramentas, com preço e o que cada um aceita.

Todo modelo que a Cut.Pro roda está em `GET /models`: modelos de conversa (Claude, GPT, Gemini, Grok, DeepSeek, Qwen, Llama, Mistral e outros), embeddings, imagem, vídeo, voz, música, efeito sonoro, avatar falante, 3D e ferramentas de imagem e de vídeo. `GET /models/featured` traz só os mais indicados de cada tipo, para quando a pessoa não escolhe.

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

```json title="200 OK (exemplo 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"]
      }
    }
  ]
}
```

Filtre com `kind`, `endpoint`, `q` (parte do id ou do nome) ou `id`.

| Campo | Para que serve |
|---|---|
| `kind` | O que o modelo faz: `text`, `embedding`, `image`, `video`, `speech` (voz), `music`, `audio` (efeito sonoro, música e edição de áudio), `avatar` (pessoa falando a partir de foto e som), `model3d`, `tool` (edita imagem: aumenta, tira fundo, apaga) ou `videoedit` (edita vídeo). |
| `endpoint` | Onde ele roda: `generations` ([Gere com IA](/generations)), `chat_completions` ou `embeddings` ([Chat e embeddings](/text)). |
| `pricing` | Créditos por unidade: `image`, `second`, `minute`, `1k_characters`, `run` (por execução), `megapixel` (do resultado; num vídeo, de todos os quadros) ou por milhão de tokens (`1m_input_tokens`, `1m_output_tokens`, `1m_tokens`; num vídeo, os tokens são os pixels de cada quadro divididos por 1.024). |
| `priced_by_request` | `true` quando o total depende dos campos do pedido (duração, qualidade): leia sempre de `POST /generations/quote`. |
| `parameters` | Os campos próprios do modelo (qualidade, passos, guidance, prompt negativo, estilo), que vão em `options` de `POST /generations`. `prompt`, `seconds`, `aspect_ratio`, `voice`, `seed`, imagens, sons e vídeo são encaixados nos nomes certos por você. Vale também para os modelos de imagem, vídeo e voz curados. |
| `supported_parameters` | Num modelo de texto, os campos que ele aceita além de `messages`, como `reasoning_effort`, `reasoning`, `tools` e `response_format`. |
| `context_length`, `max_output_tokens` | Para modelos de texto. |
| `modes`, `resolutions`, `seconds`, `voices` e demais | Para os modelos de imagem, vídeo e voz curados pela Cut.Pro. |

> Os preços mudam a qualquer momento. Leia daqui ou, para o total exato de uma geração, de `POST /generations/quote`. Nunca fixe preço no código.