API: AI Models

Visão Geral

Gerenciamento de modelos de IA disponíveis para uso nas instâncias. Permite configurar diferentes modelos Claude para diferentes casos de uso.

Endpoints

GET /api/ai-models

Lista todos os modelos do tenant.

Response (200 OK):

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "displayName": "Claude Sonnet",
    "modelId": "claude-sonnet-4-20250514",
    "isActive": true,
    "createdAt": "2024-01-15T10:00:00Z"
  }
]

---

GET /api/ai-models/{id}

Retorna detalhes de um modelo.

Response (200 OK):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "displayName": "Claude Sonnet",
  "modelId": "claude-sonnet-4-20250514",
  "isActive": true,
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-01-15T10:00:00Z"
}

---

POST /api/ai-models

Cria um novo modelo.

Request:

{
  "displayName": "Claude Sonnet",
  "modelId": "claude-sonnet-4-20250514",
  "isActive": true
}

Response (201 Created):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "displayName": "Claude Sonnet"
}

---

PUT /api/ai-models/{id}

Atualiza um modelo.

Request:

{
  "displayName": "Claude Sonnet v2",
  "modelId": "claude-sonnet-4-20250514",
  "isActive": true
}

---

DELETE /api/ai-models/{id}

Remove um modelo.

Response: 204 No Content

---

Modelos Disponíveis

Model ID	Descrição
claude-sonnet-4-20250514	Claude Sonnet 4 - Balanceado
claude-3-5-sonnet-20241022	Claude 3.5 Sonnet - Anterior
claude-3-haiku-20240307	Claude 3 Haiku - Rápido e econômico

Uso

Os modelos são vinculados às instâncias WhatsApp. Quando uma conversa é processada:

1. Sistema busca o AiModelId da instância
2. Se não definido, usa modelo padrão do sistema
3. Chamada à Claude API usa o modelId configurado

---

Erros Comuns

Status	Código	Descrição
404	AI_MODEL_NOT_FOUND	Modelo não encontrado
409	MODEL_IN_USE	Modelo está vinculado a instâncias