Pular para o conteúdo principal

Registro de Modelos

O AISCouncil usa um registro de modelos mantido pela comunidade para manter sua lista de modelos disponíveis atualizada. O registro é um arquivo JSON hospedado no GitHub Pages que o app busca e cacheia.

Como Funciona​

O arquivo de registro (registry/models.json) contém uma lista estruturada de provedores, seus modelos e níveis de preço. No carregamento da página, o módulo AISCouncil.Registry busca os dados mais recentes do registro com um cache de 24 horas. Se a busca falhar, ele cai para uma cópia local empacotada.

Formato do Registro​

O registro define provedores e modelos com metadados:

{
  "providers": [
    {
      "id": "anthropic",
      "name": "Anthropic",
      "models": [
        {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4",
          "tier": "standard"
        }
      ]
    }
  ]
}

Contribuindo Modelos​

Para adicionar ou atualizar modelos no registro:

  1. Faça fork do repositório
  2. Edite registry/models.json com suas mudanças
  3. Execute o script de validação: python registry/validate.py
  4. Envie um pull request

O script de validação verifica por:

  • Estrutura JSON válida
  • Campos obrigatórios (id, name, provider)
  • Nenhum ID de modelo duplicado
  • Valores de tier corretos

Auto-Refresh​

O registro atualiza automaticamente quando a página carrega. O cache de 24 horas previne requisições excessivas. Você pode forçar um refresh limpando os dados cacheados do app em Settings > Privacy.

Hospedagem GitHub Pages​

O registro é servido do GitHub Pages como um arquivo JSON estático. Isso significa:

  • Sem lógica server-side necessária
  • Mudanças entram no ar assim que o PR é merged e o Pages reconstrói
  • O arquivo é CDN-cacheado para acesso global rápido
  • O app cai graciosamente se o GitHub estiver inalcançável